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PREFACE 

This manual turn two priumry fund um/i. The first la en teach you haw co 
use the MS (Dick Operating System): the Chapters of the manual ubc 
examples to accompany .s[i i.ui.il I nii.-i of how the. varloun DOS commands work. 
The second function of the manual la to serve as a r*ler«rnca giiWIf 1.0 DOS. 
The Appendices,, Quick Reference Card, and the Indices (on pages 172, 179 
and: the Inside back cover) were planned with this function in mind. 



To use in Apple Disk II, you need an Apple II computer with at least l&K 
of otnory — but 32K is recommended, since the 16K system allows little 
meaory space to store prograas. For using Apple Disk II with Applesoft 
HASIC on the firmware KOH card {Part A2B01W9X) , ■."■■« i umputer nllll 
requires only I6K of wonry. For using Apple Disk II with Applesoft on 
cassette tape (Part A?T|J[!jJ4) OF on diskette, your computer must have at 
least 32K of memory. 

The Apple Disk II lp a "floppy" disk unit which allows you tn store and 

retrieve Information ouch more quickly nnd conveniently than you can with 
tape. The Information is stored and retrieved from a "diskette", a small 
(about 5-inch diameter) specially coated plastic disk which la permanently 
sealed in • square plastic case. 



One of thr Boat Important advantages tn using. Disk II Is that Information 

is stored and retrieved by a name under which it is filed. A program that 

catalogs phone numbers might be saved with an instruction such as 

SAVE PHOKE NUMBERS 

and retrieved with an equally simple command ■ The name PHOKE HUHBERS 

under which the prograaj is filed is a flic name ■ 



The programs that automatically keep creek of files, save and retrieve 
information, and do a nultitude of other housekeeping tasks arc called the 
in-.k Oper.it 1 lift System , usually shortened to "DOS". Some people say 
"doss end others nay "dec oh ess", learning to use DOS and the disk 
consists of learning a few special DOS commands described In this manual. 
These commands can be used as extensions co either Applesoft or Integer 
BASIC or machine language program*.. 

At soae places you'll see the symbol 

$ 

preceding a paragraph. This symbol indicates en unusual feature CO which 
you should be alert • 



The symbol 



(^ 



preri-ilr: ;i irngrapha describing Situations from which BASIC may be unable 
to recoveri You will lose your prograo, probably have to re-start DOSi 
and may have co re-acerc BASIC • 



Vll 



++* NOTE *** 

This manual applies to DOS version 3.2. only. — 

and descriptions may not be correct for DOS 
versions 3*1 and 3,0. If you do not have DOS 
version 3*2 k you should get a copy of It from 

your dealer before using this manual. The 

version number of IMS is shown when you Wint ^^ 

the System Master diskette. DOS version 3-2 
la on a floppy diskette, Part Q9'<-0002-03> 

Ilir KPDATK progra, i] t i-.i ui-.-'.t-it Id Chapter 5, aM 

can be used to convert disks with outdated 

versions of DOS to DOS version 3-2. 
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CHAPTER 

INSTALLATION 
AND HANDLING 



Unpack i 

lectitlg the Cable 
Installing the Controller 
Installing MulLiple Disk Drives 
Care o£ Ehe DISK II and Diske> 
Inserting and Removing Diskettes 



UNPACKING 

Your Disk II systen consists of seven iteaa; 

1) The disk drive <che main box}. 

2) A prlnted-clrcult card (the control If r card } 
that plugs Into the Apple II- 

3) A flat ribbon cubic, already fastened 
to the disk drive, for connecting 

the disk drive to the controller card- 

4) A "5YSTEH MASTER" diskette. 

5) A blank diskette. 

6) A warranty card. 

7) Adhesive labels. 

8) This manual. 

If you hove purchased a drive only (for example, an a second drive fnr 
your controller card) your eye tea "111 Include all of the above itens 
except 2), the controller curd. 

Save the packing material in case you vUh to transport your disk — or in 
the unllki-ly event you «UBt return it to your dealer or to the factory for 
service* Send in the warranty card — not only does thin put the warranty 
in effect, but It puts you on the moiling list for CONTACT, the Apple 
users' newsletter that keeps you informed of updates and new products. 

*** Special Note *** 

Before connecting or disconnect Inn 

ANYTHING 

On the Disk II or Apple II 

TURN OFF THK POWER. 

This is a must. 



CONNECTING THE CABLE 

In use, the disk drive will be connected to the controller card by the 

fl.it, ribbon-like cable- One end of lliin rihhon rnble in already fastened 
to the disk drive. If this is your first disk drive, the connector at the 
end of the ribbon cable from this drive should be attached to the upper 

set of pins on the controller card. This set of controller card pins is 
labelled "DRIVK I". 

*** Caution *** 

If the cable from the disk drive to the controller card is not plugged 
Into the controller card correctly, considerable physical danage can be 
done to the disk drive unit and its electronics. To assure correct 
assembly, be sure to plug the ribbon cable into the controller card 
lu'l'iin- I putolling the controller card into the computer. Two 
installation dps follow. Firsc, don't jan the cable between the 
connector and the controller card. When che cable is plugged into the 
GOal rn ] Iit ivird correct 3 v , the cable tthould exit item Its connector on 
the side of the connector that Is away from the cone roller card, as 



shown in tha photograph. Second, make aura iluii all Che plno of tha 
controller cird'fl connector go Into the matching holes In the ribbon 
cable'u connector. By making the connection before Installing the card, 
you can actually see that ell the pint ire going into the holes 
correctly. 




Co line. I lay, the Cable to the Controller 



If fou an- Installing a second disk drive, you should connect the ribbon 
cable from the second drive to the lower net of plea an your nmi ml Iit . 
This set of pins i» labeled "DRIVE 2". Take che sane care attaching this 

■ in-. Lur an you did with the first, 



INSTALLING THE CONTROLLER 

To install the Disk tl controller card, which you have already connected 
to the disk drlv* via the ribbon cable, you will simply plug the 
controller card into a socket InOldc che Apple 11, as follows: 

'■ Tu rn off I lir power switch at che back of the Apple II. Thin Is 
Important to prevent damage to the computer. If the power is on, removal 
or insertion of any card cmilri cause permanent damage to both the cord and 
ch* Apple II. 

2, Remove che cover from Che Apple II. this Is done by pulling up on the 
cover nt Hie rear edge (the edge farthest from the keyboard) until tlir two 
corner fasteners pop aparc. Do noc concinue to life che rear edge, but 
slide Che cover backward until It cones free. 

3- Inside the Apple II, across che rear of che circuit board, chere la a 
row of eigne long, narrow sockecs called "slots". The leftmost one 
(looking at the conpntcr from the keyboard end) Is slot M, and the 
rightmost one Is slot #7. Locate sloe #6, one socket to che lefc of the 
rightmost socket. The controller card may be placed in any sloe except 
sloe 99, che leftnont. However. Apple's standard location for Che disk 
iic roller enrd Is sloe 16, and nose Apple software (and this annual) ia 
written with that location In aind. 



«• BE SURE THE POWER 18 OH? BEFORE YOU INSERT OR REMOVE ANY CARD FROM THE 

COMPUTER, insert the "fingers" portion of the controller inco slot #6. 
The "drifters" portion Bill enter the socket with son* friction and will 
Chen seat firmly. Since the fingers make electrical contact, It is a good 
lden to Veep your fingers from touching then, before lnfttal latlort, you 
may wish to use rubbino. alcohol ti>. irle.in tin- f i-tgi-m an i In- board (anil, 
optionally, your own fingers If you're bo Inclined). 
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I-i'.i-rt Lor Che Controller Card 

5- Adjust the ribbon cable so It lays fine and passes over one of the 
areas between the vertical openings in the back of the Apple II r.ise, as 
shown in the drawing. When Che lid la instilled it will clamp down the 
cable and act as a strain relief. 
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Cable Flacenent 

(i. Replace the cover of Che Apple II; remember CO Start by sliding the 
front edge of the cover Into place* Press down «n the two rear corners 
until they pop into place. 

7. The Disk II controller is installed, and the Apple II Buy now be 
turned on. Place the disk drive in a convenient location, usually 
alongside of or un top of your Apple 11. 
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INSTALLING MULTIPLE DISK DRIVES 

Each controller card can be used with two disk drives, one attached to the 
upper act of pins, labeled "DRIVE 1", and tin- second Attached co the lower 
set of pins, labeled "DRIVE 2". Your first disk drive should be Attached 
to the DRIVE 1 plus and the second to DRIVE 2 pins on the cord in slot 06. 
The third and fourth drives should be attached to the DRIVE I and DRIVE 2 
pins, respectively, on a card In Blot #5. the fifth and sixth drives 
attach to the DRIVE 1 and DRIVE 2 pins on a card in slot *4, and so on. 

II you have multiple driven, It is a Rood idea to label the front of each 
drive with Its slot and drive number since your programs will refer to the 
disks, by those numbers. Adlie-eiivc labels are provided In an envelope with 
your drive. 



CARE OF THE DISK II AND DISKETTES 

The Disk II drive, unlike the Apple II, la a mechanical device, with 
motors And moving parts. Therefore It is somewhat more delicate than the 
computer. Rough handling, such an dropping the drive, or having things 
drop on it, can cause it to nnl function. The drive should not be placed 
bralili' or on a TV act, since the strong magnetic flcld.6 put out by TVs nay 
cause damage to the magnetic propertiea of the drive. If in doubt, locate 
disk drivea At leant t feet from any TV net. 

Each diskette is a small (about 5-inch diameter) plastic disk coated so 
that information aay be stored on and erased from its surface- The 
coating, la similar to the magnetic coating on recording tripe. The 

diskette Is permanently sealed in a square black plastic cover which 
protects It, hclpw keep It clcun ond" allows it to spin freely. This 
package is never opened. 

The term "floppy" cornea from the fact that the diskette is flexible- 
Older computer Information ntornge devices that worked on similar 
principles used rigid disks. While the diskette (and its plastic cover) 
nrc nomcwhiii flexible, actual I y bending the diskette can damage It. The 
tlltikcttej cover contains both lubricants and cleaning nRents to extend 
trouble free operation — treat covers with respect. 

Kever let anything touch the brown or gray surface of the diskette itself. 
Handle the diskette by the black plastic cover only. When a diskette is 
not In use, keep it In the paper pocket that It cane In. These pockets 
are treated to minimize static build-up which attracts dust. It la best 
to store diskettes vertically when they are not in use- Vinyl notebooks 
especially nndc for this purpose ore ■ ■nnvenient . 

Diskettes hold a tremendous amount of Information: a single diskette can 
hold over 931,000 hi is of information. An Individual bit of Information, 
therefore, occupies a very small portion of the diskette. An invisible 
scratch on the Burface of the diskette, or even « fingerprint, can cause 
errors. Do not place diskettes on dirty nr greasy surfaces; Jo not let 
them collect dust. 



To write on a diskette label, use a P£LT TIP pen- Do not proas hard, ir 
ifi best not to write on a label attached to a diskette, but to write on 
the separate label, thou attach It to ihe diskette. 

Keep diskettes away froD magnetic fields. This means to keep then away 
from eloclrlc Motors and magnets; they should not be placed mi tiip of 

electronic device* such as television sets. They nay be temporarily laid 
on the Apple 11 or the Disk II. 

Diskettes sre sensitive to extremes of teeperature. Keep diskettes out of 
the sun, and away from other sources of heat that can cause then to warp 
and/or lose data. On hot days, car trunks (or dashboards} can bo diskette 
killers. Diskettes operate satisfactorily up to 125 degrees Fahrenheit 
{51.7 Celsius), which is not very hot. The first evidence of heat damage 
Is a warped or bent black plastic cover. 

With reasonable care a diskette will Rive you an average life of 40 hours 
— whicli is a lot, when you consider the £ew seconds* It take:, hi LOAD most 
programs. With Just a little bit of carelessness, a diskette aay Rive you 
no service at all. 





Ho-Ho's 
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INSERTING AND REMOVING DISKETTES 

using a disk drive Is far quicker and easier than using a cassette 

recorder, however some care is necessary to protect the diskette!:. The 
drive i I '«■ I f miU4l n I m> he liamllotl with some care. The drive door is 
opened by pulling outward on its bottom edge. The diskette is then 
slipped into the slot with the label ntmnrrin , aa shown In the 
photograph. The edge of the diskette with the ovul cutout in the 
dla/kette'e aquare plastic cover should enter the drive firm - Tlie edRe 
of the diskette with the label should enter the drive Inst . 
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A Good 

RULE OF THUMB 

Hold a diskette with your right thumb over the label: 

that pretty such lnatirea the correct orientation 

when you put the diskette in the drive- 
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Inserting a Diskette 



Push che diskette Ren Ely until the diskette la entirely into the drive. 

Do not bend the dlnketli'! If (I f a |iur:ln*rl In Inn hard, the diskette can 
be permanently damaged. Close the drive door by pushing it down again. 
The two metal fingers (which can be seen inside the slot when che drive 
door is closed) should Just clear che diskette as the door closes. 

A diskette is removed by opening che drive door end pulling che diskecce 
carefully out of the drive. The act of openlnx the dish drive door lifts 
the "head" elf the disk. If you plan Co leave an unused diskecce in a 
drive for several hours. It's a good idea to open the door ao che head 

won't reat on llu- ! • ! , i : •. 



M-TKK remove a diskette while Hi., drive's "IN I1SK" Uglil la on. This may 
permanently damage the diskette, and Is almost sure In di-iil roy the 
information on ic. In such a case, che diskecce can usually be re-used, 
buc you won'c be able co recover che locc inforatatlon. 
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BACKGROUND 

Learning to use the disk and its operating system consists ol learning a 
iiw special instructions, several vi which ore straightforward extensions 
of familiar BASIC instruct Ions. This manual ASfiumefl that you're- familiar 
with the Apple II, nnd feel comfortable Bl ii Lag simple BASIC programs. 

To learn how to use the Apple II and Integer BASIC, consult the Apple II 
BASIC Programming Manual (Apple Product IA2L9935X). To learn how to use 
Applesoft BASIC, consult the Applesoft II BASIC P r pjg rriinm 1 n k Relerence 
Manual (Apple Product 0A2L0086). The Applesoft manual assumes you're 
already familiar with tin* Apple II and simple HASlft programming. If 
you're not familiar with either manual, we will wait here while you learn 
about the Apple II, before going on to loam about DOS. 

* 
* 
* 



® 



Kv.-n though DOS commands look like BASIC commands, they do not always 
follow the same rules. For example, multiple COS commands can not be put 
on one line, separated by commas. The SYNTAX KSROR message results. 



SPECIAL KEYS 

SometlneB this manual uses the curly brackets i and > to enclose the 
namea of special keys which you are supposed to prcsu on the Apple tt 
keyboard. 
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Throughout the manual are listings of programs th.it Illustrate how to use 
DOS. Most of those programs are in Applesoft; a few are in Integer BASIC, 
Sometimes the changes needed to convert an Applesoft program to Integer 
BASIC are mentioned; other times, they are not- Consult Appendix H in the _ 
Applesoft manual for details on the differences between program written 
In Integer BASIC and Applesoft BASIC. 

A Uttla bit of hands-en experience Is worth a lot of reading. Once your "^ 
disk drive la hooked up and the computer is turned on, follow each of 
these descriptions by actually trying out the procedures on your Apple II. 

Put th* Apple 11 into BASIC — either Integer basic or Applesoft. Place ^ 

the System Master diskette Into the drive- The diskette should be 

labelled 004-fMftlZ-XX. The last two digits arc indicated by X'o, since It 

doesn't matter what they are. If you have more than one drive, use Drive 

1. This section of the manual only deals with one drive and assumes ttiet 

you've fallowed the standard convention*, putting the controller into slot 

With the disk drive attached, and the diskette In the drive, and the disk _ ^ 
drive door closi'd. you will find Mint the Apple 11 performs Just as it did 
without the disk. Nothing is changed. It Is as if the disk drive were 
not there. And, as far as the Apple II is concerned, the dink drive is 
not connected yet: a special command must be given to inform the computer 
that the disk drive mid the new DOS instructions ere available. 



(RETURN) moans you should press the key narked "RETURN", rrami the hetukn 
key alter each Instruction. 

(RESET) Deans press the key narked "RESET". A press of tin- RESET key will 
put you into the H0H1T0H program, which uses * ns It* prompt cliiricur- 

(ESC) means press the key marked "ESC". "ESC" originally meant "escape", 
but nowadays hoe other uses. 

<CTHL> is a bit different. It mean* you should press the key marked 
"CTRL" (which standa for control) and continue hold Inn II down 
while you type another key. For example, {t'TRL)C means type the "C" key 
whil !• you are holding down the ctbl key* Sometimes use of the control is 
Indicated in another way: CTRL-C ,iud {CTRL}C biitli mean the same thing. 

*** NUTE. **» 

Characters typed while holding down rlu- CTM, key 
do not appear an tho screen. 



BOOTING DOS 

The process of adding the DOS commands to the BASIC In your Apple 11 is 
culled boot ln% the disk. The disk may be booted fron Integer BASIC, 
Iron Applesoft or from this Monitor. There are various ways you can use to 
boot DOS, From Integer BASIC or Applesoft, the PHfs and IN#s commands 
(see your Applesoft mruinal) tuy be used. From the Honltor, "control 
commands" using the CTRL key oay be used. Once you get IMS homed. It's 
all the same DOS: It dooan't Batter how you got there. 

In i he examples below, the lower-case letter s stands for the number of 
the Apple II slot in which your disk controller cord 1b lacnied. Tin- 
standard location for the controller innl is slot #6 (see Chapter 1, 
IiirUiI ling the Controller]. After any of the following commands, you mist 
press the RETURN key. 

From Integer BASIC (whose proapt character la > ) 
you can use cither of these commands co boot the disk: 

You type: PR's Fxoraple: FR#6 

or: IN#s Kxanplei IVtb 

From Applesoft (whose prompt character is ] ) 

you can use either of these comnuindri to boot the disk: 

Vim typei KR#s Example: PR #6 

or: Wts Example: IKK 

From the Honltor (whose prompt character la * ), 
you can uro iinv of these commands to boot the disk: 

You type: CsBflC ExwnpU-t i:ii|i#; 

or: s{CTRL}K Kxamplct 6{CTRUK 

or: s<CTRL>P Example: oJCTRDP 
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Tti the rest of this manual, when you ace to re-start tht DOS In this 
manner we will simply say: "boot the DOS" or "boot the disk". Both 
expressions {very popular among cosputer users) mean the same thing. 
"Boot" is short foT the word "bootstrap" and the torn is fron the 

expression "to pull oneuclf up by one's bootstraps*" but a more thorough 
etymology would be out of place here. In any case, it does pot mean to 

kick the disk, even if you do feel In such a mood from tine to tine. __ 

Now try booting DOS from your System Master diskette. Start by putting 

your Apple II in BASIC — either Integer BASIC or Applesoft will do. Be 

sure the diskette is properly inserted- Next type 

PR#6 

and press the RETURN key as usual. From now on, it will be assumed tii.it 

you will press the RETURN key after each instruction. 

Once you press the RETURN key, the ted "IN USE" light will eo»e on, the 
disk will make whirring and clacking noises (don't be alarmed — it's not 
getting ready to fly away) end in less then 10 seconds, a message will 
appear. The aeasage should be similar to the following: 

Dl TTE VC *"* 

1*- _ 

COPVRJGHT 1975" fi HPUTER 3 

If you now try to use BASIC, you will find that MM nimmaods still 

operate normally and, aside Eron the message suddenly appearing, the Apple 

11 seemu unchanged. Whet has happened is this: a few new commands have 

been introduced, and n few old ones have new capabilities. Two changes 

have been mode that are not obvious, however: mm 

11 The HlMEH pointer to the highest meaory location you nay use 

bus been reset to accomodate the DOS program. 
2) Your Apple II may have Inst none of Its high-resolution 

graphics capabilities, depending on the amount of memory 

in your computer. 

For details i nee Appendix Q on DOS Meaory Usage. 



IF BOOTING DOESN'T WORK 

U you can't successfully boot your System Master diskette, re-read the 
manual carefully — that cures 9(Jt of all problems. 



This isn't likely, but if your unit v«!> iihlpnt-d In a Sherman tank or 
such, the connectors inside the disk drive may have worked a bit loosn,'- 
If you are at all squeamish about handling the insldes of your drive, your 
dealer will be glnd to check it out. 

If you enjoy getting your fingers into the works, you can turn the 
computer off, and disconnect the drive from the controller. Loosening the 
four screws on the bottom of the drive allows the mechanism to slip 
forward out of the case. Tighten the connectors by pushing them gently 
onto the circuit boards. Re-assemble the unit nnd it "III probably now 
work. If this first aid doesn't work, see your dealer. Don't make any 
adjustments- 
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INITIALIZING NEW DISKETTES 

The System Mastar that cones with this manual iu a very special diskette: 
It contains prngmnm clmt allow you to copy an entire diskette {IE you 
have two disk driven), update any diskette that has an earlier version of 
DOS, and store* Programs that demonstrate various capabilities of DOS art 
also included on the diskette and discussed In the manual. 

Take the 5ystem Master diskette from the drive, and replace it with the 
other blank diskette Supplied with your drive, How cry an experiment- 
Get BASIC going, then type 

PRI6 

and watch what happens. The red IN USE light cooes on, and the disk drive 
make* a few clackety nolstj, then lc Just keeps whirring softly and 
quietly and it doesn't stop. You'll have to press the RESET key to stop 
it (normally, this Is o BA1) Idea, hut i hese i*ircumstances aren't normal). 
Tt's a good Idea to open the disk, drive door b ef o re p re an-i n g- tho. a £SE T 
key, since that lifts the head of the disk, drive nil i he surfnee of the 
dlekfi) i e- 

Wliat happened w.is this: your Apple II went on a fruitless unending search 

for information on a blank diskette (on a clear disk you can seek 
forever,..), when a new diskette 16 manufactured, it contains no 
I nl ii rem t lor at all* like a blank tope purchased for a tape recorder. To 
operate in the computer, there must be special information placed on the 
diskette, the diskette must be initial iaed . 

If you've been keeping up with the hands-on part oi the example, your 

blank diskette ia in the drive and you Just pressed the RESET key. Now 

cake out the blank diskette, replace it by the System Master diskette, and 

close the door of the drive. Get the rnmputer Into BASIC and type 

PRCo 

again. You should again get the Brassage you got before when you booted, 

Dure more the DOS commands have been added to BASIC. 

The UNIT command can be used to IHlTlallze a "slave" diskette. Sluic 
diskette* ar e memory-size- dependent: the_.slxe_ of a system on which a 

diskette In INTTlnl lv.ed determines what size systen can use the disk. If 

a slave dis kett e is created on .1 12K oyatcm , t hen it con be used only on 
32K systems <<t larger. But on larger systems, only 3ZK of memory will be 
used. After INIT ia 1 i alng a slave diskette, you can use the UPDATE 3.2 
program (see Chapter 5) to tranform your slave diskette into a "caster" 
diskette whose DOS is selt-relocatlng so that memory 1b une«l pi i iriently. 

The INIT command requires the use of a BASIC program called the "greeting" 

program Blnce It greets you: each time you boot the diskette the program 
will be run automat lcally. The greeting program is commonly named "HELLO" 
but you could call it "BONJOVR" or "BUENOS DIAS" or whatever you like. It 
helps keep life simple In use a Standard name fur greeting pi'i'igraM lift you 
INlTiallze diskettes. 

Here's a ntep-by-niep guide to INITiol Uing d slave diskette. We assume 
MS iu already booted OS deserlhed clbutfe. 

1) Remove the System Master from your drive and replace It with 
a blnnk diskette. 
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2) Type NEW, than type a greeting program. Here is a simple 
sample of a greeting program: 

5 REM GREET lNf,-t PROGRAM ™ 

16 PRINT "SLflME DISKETTE CREATED 

ON 32K SYSTEM" -^ 

"6V WT. 

You should supply your own name, system Hlae, the current 
dote and. other information to help you quickly and easily 
determine the diskette's history and slave/master status. 
You may SUN the program to see If it does what you expect. 

3) Once the program Is satisfactory, type this instruction: 

When you press the RETURN key, the diskette will spin for nearly _ 

two minutes, asking clacks and little whispery noises every 
now and then. The nppr«ipr I ill i" prompt character (e.g. ] for 
Applesoft) will be displayed whan Initialization is complete- 

4) When the disk quiets down and the IN USE light goes, off, 

remove the diskette and libel it. The label should say 
something like 

32K SLAVE DISKETTE CREATED fl AUGUST 1989 ^ 

oo that Just by looking at It you know It Isn't blank. 

Put aside the System Master diskette supplied by Apple CmputeC- Put It 
where it won't be damaged by heat, physical stress (kids? dogs?) or 
magnetic ohJcctB, And where LI «n'l get lost. It should be treated 
especially carefully, since It contains many useful programs. 

Once a diskette has been INITlalUed, it Will be referred to as a -slave m ^ 

dlsJteiSjs. To label your slave diskette, you had to take It out of the 
delve* Put It back In and try booting it: the message In your HUM 
statements should appear- If you followed the model given above, the 
screen should say: 

SLAVE DISKETTE Q 

8V RM JO 



Since the once-blank diskette nou can boot, you know that it has been 
INITlaJlced correctly. From this point on you will use the newly 
INITisliied slave diskette lor experimentation. You cannot do some of the 
procedures to be demonstrated below on the System Master, because the 
diskette Is "write protected", as discussed in Chapter «. 

If you have purchased additional blank diskettes, It would br a good idea 
to INlTlaltec a leu nl the™ now. 
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LOAD-ING AND SAVE-ING WITH DOS 

Boot che system with your Initialised diskette* type 

NEW 

CO nuke sure no programs are In memory, Thli will erase your greeting 

program (which is LOADed and RUN when you boot DOS) from Memory (but not 

from the diskette). 

Now type this simple program: 



S REM COUNT PROGRAM 
10 FOR I " 1 Tl 

■ 

40 END 



HIT-, i! urn ■• ,(i luii'B to make sure thai Ll VOtkt M pOU tXpmOE. In 
Ajinlrsnf t , when the program is RUN you'll Bee this! 

1 2 

6 
7 9 9 

For reference purposes , call this program ONE TO TEN, since It counts I rnm 
one to ten- To store this program on the diskette, type the InM ruri Ion 
SAVE ONE TO TEN 

When you complete the command by pressing the RETURN key, the disk will 
whirr for ;i tew rii-i nndii , .mil tin' program wl 1 1 h .ill. 

If you had typed 

SAVE 

without any name, the program would have been saved on cassette tape, ai 

usual (assuming you had operated the tape recorder as described In the 

BASIC Programming Manual }. 

To prove that the program has been SAVKd on diskette, do the Inl lowing. 

First, type 

LIST 

then 

RUN 

to see the program is still in memory and still operates properly. This. 

demonstrates that using DOS to SAVE a program on a diskette doesn't affect 
the program in any way. 

Now type 
NEW 
then 
LIST 

There will be no program left at nil — It disappeared when you ty p ed HEW . 
to really make aura the program Is dead, turn off th« computer! icu can 
even take the diskette oul and pal II (gently) bark In again. Turn the 
computer bock on again, gel Into BASIC mid hunt the DOS. Type NEW (which 
ersiti the HEU.0 program), and then LIST. Nothing there? Right- 
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Now type 

LOAD ONE TO TEH 

and the disk will whirr for about cvo seconds. LIST the program: it is 

revived. RUN ir, and you will find It in perfect health. That is all 

chart is to SAVEing and LOADlng programs from disk: it's just like using 

the oaflRette tape except that a file name is used, and it's faster* 

3 

CATALOG 

Tou scored the program OKK TO TEN on your diskette. Actually, you had 

alri>.n]y stored another program. To see what programs are stored on a 

given disk, type the command 

CATALOG —i 

and a list of all the programs on cha diskette will appear* Right now 

your diskette's catalog should look like this, If your programs were 

written in integer' BASIC. 

! Hi 

I m: Mil in 



WHAT'S IN A NAME? 

File natoes must be from 1 to 50 characters in length; DOS will truncate 
longer file names to 39 characters. A file name must begin with •■> letter. 
Any typeaMe character, except the comma { , ) may appear in the name. 



16 



3 



Tin- li'tlrr "I" In Lhe left rolurn means that the programs are In Integer 

BASIC; before mm oj Applesoft programs y ou'll see on "A". Besides 
BASIC program filas, there are also other kinds of files that can be 
stored, and they will be explained in Chapters 6 through 9. The numbers 
after the file-type letter represent the length nf the fttnred program. In 
this case. 002 diskette "sectors" were required to store the prograta. 
Each diskette aector can store up Co 256 bytes of Information. The 
shortest possible file, an empty text file (sec Chapter 6), requires 001 
sector to record certain "housekeeping" Information. In all, a diskette 

can store 4(fj sectors nf programs and other files. Lastly, each entry In 
the catalog contains the naoe of the program. Sec Appendix C for details 
on how information la scored on the diskettes. 

When a file exceeds Z55 sectors, the length reported for that file by 
CATALOG starta over again at 000. 

There is no way to tell from looking at the CATALOG which program i« the 
greecing program. So it helps if you alvaya give the same name to your 
greeting program. To change the name of the greeting prograta., see the 
discussion of the UPDATE program, In Chapter 5. 

Sometimes you'll have onre programs on A diskette Chan will fit on the TV 
screen at one time. CATALOG will cause the first 18 programs to be 
listed. When you're ready to see the other programs on the diskette, 
press any key except the RESET key, CTRL key or the SHIFT keys. 
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Here are lose legal fill nanves: 

SOMNAHBUL1STICS 

ONE TO TEK 

HIRES 34 

THE QUALITY (IK KBtCYl UNSTRAINED 

Here e few names that will pot work (and (uhh why): 

1 TO 10 (begins with ■ digit) 

HI THERE. BABE (contains a conoa) 

INEPT EXCESS VERBIAGE DISQUALIFIES NAMES (will be cut to 30 characters) 

Although the nane of the last file will be cut to 39 characters when 
displayed by CATALOG, you can. if your fingers can take it, type the 
entire name when LOADing or RUNning, and all will work correctly. 

Every line in the catalog represents a "file". The BASIC progr.™ you 

m or <'d is an ciuimplp of a file. The rules given here for file naoei also 

;i]i|i]y to the naiwa of program*) • 

If a control character is accidentally (or even purposefully) typed Loco ■ 
nun*, that character will not appear on the screen when you get a catalog. 

For example, If you lypi- {cTKL)T Instead of plain "T" in tha naoe 
"AGATHA", the catalog listing would appear to be 
ACAILA 

However, if you tried to LOAD that file by typing 
! ■ ■ •,■:-. ■'. 

the computer would reply 
HUB NOT FOUND. 

even though the name you typed seemed to be identical to the name In the 
catalog. So be careful: don't Inadvertently put control characters in 
flic names. (Although, heh heh, it's a clever way to keep you out of my 
bank records If all files have secret control characters embedded in 
then...) The File Names section of Appendix F contains tips on how to 
find out vhot control characters ere imbedded In file names. 



RBiAMI-ING FILES 

For one reason or another, you'll occasionally want to change the nam* of 

a file. Suppose you get tired of typing tha file name ONE TO TEN and 

decide to call the rile COUNT. .lust type 

RENAME ONE TO TEN, COOTIT 

and after a moment of whirring you'll again see the BAKU: proeipt 

character. Now type 

CATALOG 

to verify that all went as planned. 



The RENAME cosmatid does not check to see whether the new name you're 
using already csists or not, so Lt''< ir.r I re] y possible that you can RENAME 
until all files on a diskette have the same name... a most undesirable and 
confusing situation that is best avoided. 
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DELETMNG FILES 

Tr Is easy to remove files from the diskette. Type 

CATALOG 

again to ace the two fll«s that are on your diskette. Sow type 

LOAD COUNT 

(assuming, you changed the tile name an shown above) U get that program 
into aemory. Delete this program from the diskette by the instruction 
DELETE COUNT 



md teat that your deletion has worked by typing. 
CATALOG 
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Only the greeting program — probably called HELLO — la left- Since the 

prngraa COUNT is in oemnry (that's why you LOADei it), you can place it 

back onto the diskette with c'.ie familiar command _ 

SAVE COUNT 

Take a look at the catalog to see that the pro&rao is again on the 

diskette . ■» « 

If you try to DELETE a file that's not on the diskette, you'll receive the 

FILE NOT FOUND 

message . 



RECOVERING FROM ACCIDENTAL RESETS 

Suppose you're with out the DOS in either Integer BASIC or Applesoft. 
(If Applesoft la in firmware, we assume the BwltCn on the card is set for 
Applesoft) . If you accidentally strike the RESET key, you con recover 
with your prograa Intact by using CTRL-C. The DOS also has recovers 
procedures that will usually preserve your program and data. 

If you have already booted DOS, and then press RESET, you get the Monitor 

( * ) prompt- To return to DOS and the BASIC you left, type 

3B0G 

Remember that's u sero, not the letter O, between the letters D and C 

If recovery to DOS does not work, and the program still LISTs, all la not 
lost i auve the progrjin nn Mi|ie (you did remember to keep your tape drive 
for Just such an emergency, didn't you?). Then ac your leisure you can 
boot DOS, LOAD die program iron tnpe, and SAVE it on a diskette. 



If you accidentally (or lntentionolly) hit the RESET key While the disk's 
red "IN USE" light is on, the information on your diskette nay_ be 
clobbered. Problems are most likely to occur If this happenu when you're 
putting Iniornation onin i In- diskette using a SAVE, BSAVE, or WRITE 
command. In the event that it is clobbered, you probably won't be able to 
recover your programs from the diskette. If nothing else works, you can 
re-Initialise the diskette nnd use it Again, but IHITlalizing destroys 
all the files on the diskette. 

If your IN USE light stays on for several minutes but you don't hear the 
unwil dink sounds, your System may be "hung". Pressing RKSKT may be the 
only way to turn off the light so you can restart the system. 
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A diskette ear be partially clobbered, is chat It will not boot. However, 
in such ■ circumstance, you can aometiaea boot another diiksttc, then 
LOAH prograaa (mm ilu- p.irti.illy u lubbiTitd diskette And aave them on an 
un-damaged dlukettc. Or you ny find tlint the UP1JATE program (see Chapter 
5) may help you save the day and your program** nt ChG same) time* 



( 
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CHAPTER ' 

EXERCISING OPTIONS 



Drive, Slot, and Volume Options 
Syntax 
INIT 

LOAD, RUN and SA 
"TE 
anario: boot, CATALOG, SAVE, RUN and DELETE 
/lug Hprween Languages: IT and INT 
Use of DOS From Within a Program 



DRIVE, SLOT AND VOLUME OPTIONS 

Most DOS commands allow you to specify a nunber of options, such as which 
disk drive you are using., which sloe contains the disk controller for that 
drive, end a "volume number" for the disk. 

The disk drive option allow? you to operate with more than one drive. 
Each controller has the ability to control either one or two disk drives. 
Normally, Ine t rutnionu refer to drive 1. This la the do faul t drive 

selection: if you don't specify a drive, drive 1 will be used. If you 
wish to specify drive 2, you use the notation D2 separated from the file 
(Wise or other disk options by a comma. For example, to Initialize a 
diskette in drive 2, you could use the Instruction 

UltT HELLO, 02 

After drive 2 hvifi been upeclfied, all further disk coaaanda reier to 

drive Z until drive 1 is again specified, Drive 2 is now the default 

drive. After the above initialization, the command 

CATALOG 

will list the files stored on the diskette In drive 2. To specify drive 

1, yon uue the notation Dl separated from the file neme by a conn. For 

example, 

CATALOG, Dl 

will show you the concents of the diskette In drive 1, and change the 

defctllt drive nunber back to I. 

If snore than tup drives are in use, then additional controllers are 
required. These are placed in different slots than the first controller 
(which if. mist iim.irl 1 y In ft lot number 6). You can specify slot n (where n 
Is a digit from 1 to 7) with the notation Bd »opar«ted from the file nam* 
or other disk options by a comma. For example, to initialize a diskette 
in drive 1 attached to a controller in sloe 3, you would use the 
instruction 

1NIT HELLO, S5, Dl 

The file name oust come first, but order of the options is not Important- 

The default slot number is the one you UBed when booting the IMS. Once a 
different slot number has been specified, it becomes the default slot 

nunber until It ift explicitly changed. 
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After using a DOS command with n Slot parameter naming a slot that doesn't 

contain a disk controller, you get an 

1/0 ERROR 

message, and all appears to be fine. But DOS now thinks the default viol 

number la the bad slot nunber, and that the disk that isn't connected to 

that slot is still running . Even if the next DOS command specifies the 

tight slot, It waits In I laho forever for the non-exifitent disk to 

stop running the last command, tf you have no program in memory that you 

Care to save, simply re-boot DOS. To recover with your program intact, do 
this; 

1) Reset the default slot by typing 

CATALOG, Ss 

where s is the correct slot number. 

2) When the systen hangs, press the RESET key. 
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3) Type 
3D0C 
and nil should be fine again- 
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DOS must be booted from a diskette In Drive X noE Drive 1. 

The volume number option can be used to protect diskettes iron being 
accidentally written over* For example, suppose your have a 

diskette-based Inventory system, where each month"* record* Is on a 
different diskette with a unique volume number. Then when you go to enter 
information for the nonth of January, you muyl he nutc to specify the 
correct volume number. Otherwise, the information won't be written to the 
diskette and you'll jet a 
VOLUME MISMATCH 
BHMgli 

A "volume number" may he uuulgned to a diskette when It is INlTlalizcd, 
uBlri>. the mi 1,1 1 inn Vn separated from the file naoe or other disk options 
by o comma. Tor instance, to initialize a diskette ualng the name "START 
UP" for the greeting program {the program that is run each time the 
diskette la booted), where* the diskette la in drive 2 of a controller in 
Blot S» assigning the diskette a volume number of 128, you would uae the 
command 
INIT START UP. P2. S5, V126 

® 

The volume number of a diskette amy not ha changed without re-INIIiallilng 
the diskette. 

The drive nunhc-r, ulot number and volume number options may appear in any 

order. The above command la equivalent to 

INIT START UP, VI28, 55, D2 

and to 

INIT START UP, S5, VI 28, D2 

and so on. 

The volume number of a diskette muse be an Integer from 1 through 254. If 
no volume number Is specified with INIT, a default volume number of 25'i la 
assigned to the diskette. 

The command 

tHIT HELLO, VB 

doea not give any nwieiiigc , but assigns the diskette the default volume 

number Z5«n 

All DOS commando con specify the volume number, if you wish DOS to check 
ih.ii i he volume number on the diskette agrees with the V option. If you 
do not specify any volume number, or if you specify volume zero, or if 
you type "V" without a number, DOS will ignore the diskette's volume 
nuober. If ynn .n , i !. T i 1 1 1 y ypcciiy on incorrect volume number, the 
system will reject it with the message 
VOLUME MISMATCH 
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Volume mismatch errors cannot occur when you ask co ■■* the CATALOG. In 
rase you wish to know the volume number of a diskette, it is given at the 
head of the CATALOG listing. 

Additional discussion of options Is found where each command is 

introduced. Also, the Information 1b concisely summarized for each 
command in the Command Summitry Appendix ami on the qui etc Reference Card 
accompanying this manual. The following section explains how to Interpret 

EQAfle concise summaries. 



SYNTAX 

Syntax refers to the structure of a computer command, the order and ^^ 

correct form of the command's various parts. A simple mention Is used to 

describe the syntax of each DOS command. Items in brackets ([ and I) ere 

optional; optional part? of a DOS command may be specified in any order. 

CAPITAL letters and commas must be typed as shown; lower esse letters 

stand for items you oust supply. In specifying the syntax for DOS 

commands, 

t stands for a file ansa 

d stands for drive number -- either 1 or 2- 

s stands for slot number — I through 7- 

v stands for volume number — 1 through 254, usually. p.. 

A diskette's volume number oey not be IJ- Specifying a 
volume number of t in a disk command is s "wild card" that 
tells DOS to Ignore the volume number on the diskette- 

Additional abbreviations used in this manual are summarized nl the start ^^ 
of che Command Summary Appendix, 

Any numerical constant (the drive number, volume number, etc.) in a DOS 
command can be expressed in hexadecimal notation by preceding the hex 
digits with a dollar sign. If you don't know what hexadecimal notation 
is, ignore the preceding statement — you need't understand hex notation 
to understand this manual. 



MIT 

The syntax for the IHIT command is 

INIT f l.vvl [,Ssl r.Dd] 

where the brackets indicate options which may or may not b* included. The 

example 

IHir HELLO, m, D2 

can be Interpreted as follows. 

The command nnme "IS1T" la In upper case, and must be typed exactly a« 
shown. The lower rase "f", for file name Is re-placed by the legitimate 
file name "HELLO". Next the optional volume number is indicnteds first 
comes o commit > then the upper ease "V". The "v" for volume number was 
arbitrarily replaced by 17 for this example. The brackets around ",Ss" 
indicate that specifying the slot number is Optional for the INIT commands 
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In chla example it's omitted so DOS will use che default slot number. The 
drive option li included: the comma and upper case "D" nusc bo a* shown; 
the lower casa "d" la replaced by 2 In this example. 

For detail? on using IHIT, lie "INITUllilng Kew Diskettes" i«i Chapter 2. 



LOAD, RUN AND SAVE 

LOADlng, RUNnlng and SAVElng programs on Hit- disk IB similar to the 

corresponding operations using the cassette (except that programu arc 
referenced by file nane). Everything goes at least ten tines faster, and 
you never need to press, buttons to play, record or rewind. It is all 

automatic. There art' many ,-■ rl <1 1 I li-n.ii 1 abilities that the disk brings SI 
well, such as the catalog of programs and the automatic running of 
programs without user Intervention. Saving dats (on text files — see 
Chapter ft ) 1b also very easy. 

It's s good Idea to hang on to your cassette tape sysceo for trading 
programu and as back-up storage for vital progrnnus and data (although 
experience shows that disk storage Is even more reliable than cassette 
storage of programs and data) . 

If you have a program in BASIC, and you wish to call it hENRY, then the 

comas nd 

SAVE HKNKY 

will save it on the diskette. If you have more than otto drive, HENRY 

normally would be saved on the drive from which you booted 1WS (the 

default drive, unless you specified a different drive after booting). You 

can specify drive number , volume number and slot number as with the INIT 

cooman.il. For example, to SAVE a file called AGATHA on drive 1 of Che 

controller in slot 2, where the volume number of the diskette is 214, you 

could use the command 

SAVE AGATHA, D| , S2, V2I4 

As before, the three options can be put in any order. If you had omitted 

the volume number uptfnn, AGATHA would have been Raved Just the same, 

bless her, but DOS would not have checked that the diskette was volume 

214. 

Program n a ties are file names, and must follow the file name rules: they 

may be up tn 110 characters I ring, mid rami I isinri ultli a letter. They may 

Include any characters you can type except commas or control characters. 

Here are some valid names for files: 

CHECKBOOK 

THE QUALITY OF MERCY 

HIRES V, 

HOW; HEAR THIS I 

To load a program named AGATHA, use the command 

LOAD AGATHA 

and the program of chat nam*. If there is one In the catalog, will be 

loaded. To cast If AGATHA la loaded, see If she csn wslk a straight line. 

If you want AGATHA to RUN alter she's LOADcd (poor thing) you can, of 
course, use tho commands 
LOAD AGATHA 
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Chen 

RUK 

But there's a way to do It In Just cm' step: 

RUN ACATHA 

is a DOS command thet first LOADs the specified file, then RUNa It. 

Here's the syntax for the SAVE and LOAD and HUN commands! 

save f I.SsJ [,Dd] l.Vv] 

l-OAD f l.Ssj j.Dd] t.Vvl 

RUN f I.SsJ [,Dd] (,VvJ 

E*aop)i'!( fill law: 

SAVE OUR HAPPY HOHE, Dl, B? 

LOAD UP 

RUN AMOK, S7 
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If, ulu-n you try to SAVE a program , you get a SYNTAX ERROR aeaasgc. 

either you have made a typing error, or DOS Isn't booted > First, try 

re-typing the command. If DOS was, originally booted, use 

1D0G 

to try to recover. If DOS isn't booted — DON'T BOOT IT. BcmtlnK MS 

will erase eiwr program in Taeaorv. First, save the program on tape, using 

the usual cassette 

SAVE 

command. How boot DOS. Next, use the usual cassette 

LOAD 

command, to bring the pr<>p.r'"" back Into your APPLE II "s nearoty froo the 

tape. Now you will be able to SAVE II <>n dink. 

It o dlski' tli- In bnil (perhaps F.omcane tried to staple it Into a notebook), 
or if the diskette is not i nitialised, or If there In n o diskette in the 
drive , or if th e door ii ope,n. the message 

I/O KK KOH 

(I/O yin'ml;. I'nr Input ur Output) will appear when you try to SAVE or LOAD 

using dqs. Check nil the itema listed, and correct the problem. You 
don't need to re-boot DOS. Try again. 

I f you use the command 

LOAD HENRY 

and HENRY is not the none ol a program an Hit; diskette in the drive, then 

you get this aessage 

FILE NOT FOUND 

Look at the diskette's cat o log tn find the program's exact file naoe. All 
characters and spaces oust be typed exactly «« they appear In the tile 
name shown In the catalog. 



DELETE 

To eliminate any file that you would rather not have on your diskette, the 

command 

DELETE 

can be used. The uynCax t8 

DKI.KTK I (,S-iJ l,Dii] [,Vv] 
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For example, thi- command 
I1ELETE EXCESS, V34, D2, SI 

deletes a file nanu>d EXCESS from a diskette with valu«e number 34, which 

is placed in drive 2 of the controller In slot I. 

Sector* on a diskette are "aet free" only wh.-n ,i I i i • ■ u. ijeletKiI. 



A SCENARIO: BOOT, SAVE, RUN, CATALOG AND DELETE 

Suppose you're running Integer BASIC and the System Master diskette is in 

your disk drive-. Here's a dialog as it night appear on the screen of your 
APPLE II. The parte you type Mtt underlined , although they do not 
appear that w«y on the TV screen. 

>PR#6 

(the above will cleat the screen end you'll see the following:) 

D1& 
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CCB 
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At thi ii point, you would insert the Slave diskette you 
INlTlallzed earlier, since It is not write protected. 

DISK ' 294 
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P.54 
I 002 HELLO 

MSI a 

•-* HO B _ 

tRE 9ERUI " 

VOLUME 254 ^ 

i ee.- 
MOVING BETWEEN LANGUAGES: FP AND INT 

Suppose you've been using. Integer BASIC, and you decide to write a program 

In APPLESOFT, or to use the computer at* o calculator with Moating point 

numbers (numbers with decimal points). To invoke APPLESOFT without 

clobbering DOS, type 

KP 

(that's all there Lg te It) mid In a feu seconds APPLESOFT will be up and 

running. The FP stands for "Flooting Point", •>[ i-ourse. (If for some 

reason Applesoft Isn't available — It's not In firmware or on the 

diskette that's In U9C — then the message 

LANCillAKT; NOT AVAILABLE »■% 

will be displayed.) The syntax for the command is 

FP f.SnJ I.Ddl 

"here the optional Slot arid Drive parameters allow to to Specify the drive 

containing Applesoft on a diskette. 

If you've been using APPLESOFT and DOS, you can type 

INT 

(for "Integer BASIC") to return to Integer BASIC with DOS tn.ta.ct- The 

suntax for this command ia simply »— ' 

INT 

without any parameters. You'll generate a 

SYNTAX ERROR 

message If you try to use the D or S parameters with INT. _ 
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II you typa 

h;t 

while in in; i-f.eT has it: , vnn will lofte any program In memory. Similarly, 

If you type 

FT" 

while In Applesoft , y ou'll loaa any program In memory- 

when you nwitrh from Integer BASIC to Applesoft or vice veraa . you'll lo ie 

any program you happen to have in memory. 
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In Addition to moving back and forth between the Apple's BASICS, you nay 
w i -,h to enter the Monitor and be obit? to use DOS connumds. To do so from 
either Applesoft or Integer BASIC, type 
CALL -151 

and you filumld grl I In- Kmilliir ptucpl i li.l i Mr t ,-: . * . I? CSTCUXD tfl 

whichever BASIC you started from with your program and DOS Intact, type 
3DK 

From the Monitor, you ■»;• also type 

1ST 

to return to Integer HASTC, or 

FP 

to return co Applesoft; In either case, DOS will still work but any 

program In memory will have disappeared . 

© 

If you get a 

PROGRAM TOO LARGE 

message when trying to execute An 

re 

command,, type 

INT 

first, to reset the system- Then type 

FP 
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Even though your diskette contains the Integer BASIC program named 

APPLESOFT, ^2 not type 

RUN APPLESOFT ~ 

If you do, Applesoft wilt seem to he running fine until you press RESET, 

say, and try to re-enter Applesoft, Then, since the DOS thinks yon are in 

Integer BASIC (because APPLESOFT Was an Integer BASIC prognm) , you will 

lie in trouble. 

To move the APPLESOFT program fron one diskette to another, simply 

LOAD APPLESOFT 

Erom whatever diskette It's on, then place the diskette you wish to 

contain Applesoft in the drive and type 

SAVE APPLESOFT 



USE OF DOS FROM WITHIN A PROGRAM 

Very often It's useful to be able to execute a DOS command from within o 
BASIC program. For example, you say wish your greeting program on a disk 
to print out the contents of th* disk by doing e CATALOG command. Many 
DOS conmuinds can be executed Erom Inside a BASIC program. This is done by 
PRINTlng a string that consists of a CTRL-D followed by lha command. 

Here la an Applesoft program that, If used on a greeting program, will 
cause the information in the PRINT statements in llneB 20 and 30 to appear 
on the screen, followed by a list of file* in the CATALOG, 
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5 REM GREET I 
10 M 

D 

— ■ 
■ 

8 RUCU — 

The recoomended way to do this In Applesoft ii illustrated In the above- -— 

program. Firs t the fit tin g "$■ consisting only a( a CTRL-D, is created 

usinR the CURT function, in the fine lln* of the program- Later H 040 be 

ua«3 «a in 1 1 in- 4." 

4fl PR TNT [>$j "CATALOG" 

No lb che seni-colon after the DS and the quotation marks around the DOS 

command . The semi-colon la optional In Applesoft PRINT stateocnto, so If 

a program has cany BOS commands in PRINT statements, you may find it saves 

typiny, rlni- .nil] mi-raury wpm <■ bo Haply uinit them, and use the form __, 

4B PP.IKT DS"CATAI.OG" ■■■ 

In Applesoft, you can use the CHR5 function to specify CTK1.-D 

10 D$-CHRS{4): REM CTRL-D 

But you need to recall that the ASCII code for CTRL-D la 4, so a REMork 

may be useful. (The CHRS function Is not available in Intagar BASIC.) 

In either Integer BASIC or Applesoft you may define- CTRL-U by mm 

typing the characters •** 

DS-" 

then typing the letter D while holding down the CTRL key, and Chen typing 

tha quotation mark, ". Note that the CTRL-D iwa not print on your 

TV screen. The final command will appear as 

OS-"" 

Since control characters do not print, it's often a good Idea to follow 
with a REMark to remind you of what actually It* In the ntrlng.. Here's the 
above program written In Integer BASIC: 
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Using the right-arrow to copy a BASIC statement containing an invisible 
control character will i.'t«mm i he control character. 
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Only one DOS command may be used In i PRINT statement. The PRINT 
statement must begin with the CTRL-D and end with the DOS enmmand. 
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In DOS commands executed by a program, the DS muse be preceded by a RETURN 
or it will be Ignored. RUHnlng tills program 



TESTCfl GOGRflM 

18 W = 

_ 
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will cause 

TESTCATALOG 

cn be tlliipl/iy.-d, alocc th<- fii-nX-ciilan iu«j>pressea the RETURN at the end of 
(he PRINT command in line It- To correct this, end cause the DOS eoaaund 
CATALOG in In- i-.m-i hi i-il when Che profiram ia RUN, Just delate the »emi-colon 
(|> iron r II,- end ■ >■ ll.u- 29. 

The if DOS commands should only be used within programs In a PRINT 
scatemenc beginning, with a CTRL-D: 

OPEN 

APPEND 

READ 

WRITE 

P0S1TIOH 

These DOS commands may be used In lmncdlace-executlon mode. unH u1.hu friin 

wlililn prog ran using a PRINT cnnauind. with CTRL-D: 

CATALOG BSAVE 

SAVE BLOAD 

LOAD BRtlN 

KLIN EXEC 

DELETE CLOSE, 

RENAME CHAIN 

LOCK and UNLOCK PR* 

HON nml NOHOH IN# 
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The DOS command MAXFILES nay be used as described above In en Applesoft 
program, but It Bust be used In a special way from an Integer BASIC 
program, as discussed in the section nbouc Che EXEC comnmnd In Chapter 7. 
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The DOS command INIT should be used only in immediate-execution node 
(dire consequences may resulc if you ignore chis admonicion) . 
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CHAPTER 

PLAYING SAFE 



Creating a ItU System 

LOCK and UHLCM 

VERIFY 

Write-Protecting a Disk 

Protecting Yourself Against Disaster 

Using the copy Program 



Two ways of protecting you and/or your diskettes against disaster have 
already been mentioned. Chapter 3 mentions using the Volume option to 
ensure that you place Information on tin- desired diskette. The use of 
control characters in file names can also be used as a way of protecting 
yourself (see Chapter 2, "What's in a Name?" and also Appendix F. "File 
flames"). If what appears in the CATALOG as 
MY BAKK ACCOUNT 

In fact has your Initial.". pLacad M BOfitro] characters at sane polnl(s) in 
the name, then it "ft unlikely thnt anyone else can access the file- 

This chapter mentions a variety of ways of protecting you and your 

diskettes again.".! various undesirable events. You'll probably find one or 

more of the techniques useful at ona tine or another. First, consider 
amklng a special purpose "turnkey" system. 



CREATING A TURNKEY SYSTEM 

Suppose a liortnr wants to do the oTflce accounting on an APPLE II. 
Ideally, the office staff should be able to simply turn on the APPLE II, 

typ, 

{RESET) 6{CTRL>P (RETURN) 

and immediately he in t He- mlri-rt ni the doctor's accounting program- Since 
the accounting program would (hopefully) comminlcntc with the user In 
ordinary English, the staff wouldn't need to know BASIC or anything else 
about the APPLE II. The computer would bpfnae an accounting system, it 1 . 
in! . • 1 1 1 ,-i ] characteristics unimportant since all the staff needs to know Is 
how to use the account ing program. 

Thin Is the essence of a "turnkey" system: from the user's point of view 
the computer 1b a device thai does unly n particular task, and Retting the 
■I ia on lilmplc as turning a key In a lock- In this cone, the 
"key" 1b simply turning on the Apple's power switch snd pressing five keyB 
on the keyboard. it does not require computer expertise to be able Co do 
that. 

You can use the diskette's "greeting program," named when you INlTlalixcd 

the diskette, tn rurn your APPLE TT Into «t turnkey ayntesi. Let's say that 
yon wanted the computer to run the COLOR DEHO program (provided on the 
System Master diskette) every tine you booted Disk II. Here's how: 

1) IN IT la 1 1 ice a blank diskette, as di-m-rlbed in Chapter 2. 

2) place the System Master diskette in your drive and typ* 
RUN COLDS fFHO 

Once you're satisfied that the program RUNs correctly, type 

(CCTLW 

to atop the program and return to BASIC. 

i) Pal yew newly IMttl*ll««td diskette Lata your drive. We'll 

Bssueje that you celled your "greeting" program HKl.l.ll when 
you INITialized the diskette. 

4) The program COLOR DEMO la now in memory. When you type 
KAVK Hr.l.U) 
DOS will erase your original greeting program named 
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HELLO and save the COLOR DEHO program under the HELLO 
I Hi- mime. Tin: COLOR DEMO program is now the greeting 
program an your diskette* 

To check that all works as expected, boot the disk. 

You should get the sine program that you used in step 2). 

You've Just created a turnkey system: whenever that diskette ll booted, it 
will automatically LOAD the COLOK DEMO prog-faa and RUK it. 



LOCK AND UNLOCK 

Sometlnea you'll want to prevent a particular prog ran £ro« accidentally 
being erased froo a diskette: the LOCK command will da this for you. 

Example! 
LOCK NESS, DZ 

The CATALOG of this diskette's contents will now show an Asterisk ( * ) 
resit to the entry for NESS. 

11 you decide you no longer wish to keep the file LOCKed, tha UNLOCK 
command will (surprise!) unlock the file. 

Example: 

UNLOCK NKS:- 

The syntax for the commands li 

LOCK I |,Ss] [,Ddl r.VvJ 
UNLOCK t l,Sa| C.MJ T.Vv] 

The Interpretation n! r'lir nolni Inn 1m discussed in Che Syntax section of 
Chapter 3. 

11 you try to DELETE or RENAME a file that's LOCKed you'll receive the 

message 

VILE LOCKED 

i in' II iiktn hi this* Bcntiugc it" you try lo SAVE n file using the naae of a 

LOCKed file (it the file you're trying to SAVE is in the same language as 

the LOCKed file). 

® 

If you try to SAVE a file using the name of a LOCKed file in a different 

language, then you'll receive the message 

FILE TYPE MISMATCH 

Try again, uulng a dlffsronl Hie name. 



VERIFY 

Orrnri I tin. 1 1 I y I nl nrnuil Inn rruiy nut be recorded correctly an 4 diskette* 
This Bay happen if the diskette is scratched or dirty * for example. The 
VEHTFY comnand reports a Cll* which nay be damaged or written Incorrectly- 
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The syntax li the usual one for DOS cunnuindst 

VERIFY f [,8s] [,MI l.Vvl ,- 

Examples of the way to use the cooBand follow: 

VERIFY SAH 

VERIFY FIWAHCE-8,D2,V22 

VERIFY checks to see that information in the specified file is 

Belf-conoi6tent. if it is, you see no menage: the proopt character for 

the language you're using is nlaply printed: 

> for Integer BASIC _ 

I for Applesoft 

* for the Honllor. 

However, VERIFY docaii't check to U( whether or not a program If. 

clobbered. I£ you SAVEd a program that was nessed up somehow, it will 

still be wflird up on the diskette, and It will Still VERIFY. 

If the VERIFY command finds an error, the 

I/O ERROR ^ 

message lo displayed. 

II vu try to VERIFY a file that isn't on the disk, the message ~m 
FILE HOT FOUND ™ 
la presented. 

a 

You can use VERIFY from Integer BASIC, Appleaoft, or the Monitor. From 
these languages you may VERIFY any type Of file, including text flics {see 

Chapters f>, 7 and 8) and machine language programs tsee Chapter 9)- 



WRITE-PROTECTING A DISK 

The LOCK command allows you to protect a particular file. But sometimes 
you will want to be sure that all files on a certain diskette are not 

accidentally written over, and thus lost. To "wrlte-protect" a diskette, 
yog merely need Co cover up the squarish writc-pmceci rumm In the side 
of the dlsfct Stick-on adhesive labels are supplied lor thla purpoae when 
you purchase diskettes but, in a pinch, any piece of sturdy tope will do. 
Note that the System (buster diskette does not have a vrlce-protect cutout: 
it is permanently write-protcctcd. 



vrllv-prct-rci cutout. . 


| ^i li hi i n | ^ 
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If you decide you want to re-uec a wrlte-protected diskette, simply remove 
the label (often called a "tab") that covers- the write-pro tec I Cutniil. 

Some programs cannot be used with ■ wrlte-proteeted diskette. An example 

of such ■ prograc is ANIMALS, one of the demonstration prngriimft of the 

Syscerj Master disk. Put your System Hatter in your drive, end boot DOS if 

you need to. Sow type 

LOAD AKIHALS 

which will put the program Into nonary. Now type 

RUN 

and the message 

WRITE PROTECTED 

STOPPED AT 1040 

will be displayed. ANIMALS won't RUN on n wrl te-ptotected diskette 

because it saves Information on the diskette each time you play the game. 

When you RON the progran, the diskette in the drive mist not be 

write—protected, else the Information can't be written on the diskette* 

Kow ANIMALS Is In memory, but you can't RUN It with the System Master 

diskette. Put nn In i I lal i r.rd diskette, one that Is not write-protected. 

In the drive- Next type 

RUN 

and now you can ploy ANIMALS, o gone that will "remember" what you "teach" 

ic by saving the Information on the diskette. When you're through 

playing, type 

SAVE ANIMALS 

so that you'll have the game on a diskette that's not writo-proterted. 

If yon t y|ic 

CATALOG 

you should see that you have not only a copy of ANTMAI.K on the diskette, 

but also a new file called ANIMAL5FILE that was created by the program 

ANIMALS. 



PROTECTING YOURSELF AGAINST DISASTER 

Floppy disks are sturdy and reliable compared to some other ways of 
storing computer programs -- for example, on the backs of old envelopes. 
But it's still possible to lose or destroy all information on a diskette, 

A diskette may get nrrueehed irr damaged by licit ; It may get lost, or a dog 
may chew It; someone may decide to use It 03 a fri&bee at the beach; If a 
diskette isn't wrlte-protected, ic may accidentally get written over. And 
a diskette will eventually wear out -- a lifetime of 40 working hours la 
about average. 

** Haril ** 
Ki>ep more than one copy of a progress around if you don't want to lnfte It. 

in computerese, "back up" any valuable program. 

If you are in the midst of writing or modifying a program, one way to back 

up the program la to keep copies of earlier versions. Then if the current 
version is lost you can fall back to the next-mosc-recent version, and 
hopefully not lose too much programming tine. One goad way to do this la 
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to end each file naoe with a number which changes Iron version to version. 
For example, suppose you start to write a program called FINANCE. Tha p_ 
first time you save the progran, rail It FINANCE-! . Next tine you work on 
the program, save it under the name PINANCF.-2; the third time, it becomes 
HCE-3, and so on. tou'U wind up with a whole collection of FINANCE 
programs, with the largest version nunber representing the cwst recent 
version of the program. 

a 

It's g good idea to SAVE a developing program periodically (with a now 

version number). If you do this every IS or 20 minutes, an unexpected _ 

[hjult failure or other disaster will not erase all your work- You can, 

ol course. Immediately continue working after SAYEing the current state of 

the program — Just be sure to assign a new version number for the next 

5AVE. If the diskette starts filling up, DELETE some of the earlier 

versions* But It's a good idea to keep several versions around, in case 

something calamitous happens to the current version. Or you nay |usi 

happen to want an earlier version — not all revisions are Improvements . 

The phrase "bncklng up" Ib also used to describe keeping oultiple copies 
of prny.r.ims mi ..-|i.n j r •_• diskettes. There arc two approaches to backing up 
in this fashion. ThB first method works with only one drive: simply SAVE 
ill. program on one diskette, reoc-ve that diskette fron the drive, insert 

another diskette and SAVK tin- program ngaln- 

The second approach involves dtipl lr.it Ing 'ill the I nf orouit ion from uuie 

diskette onto a second diskette; this works only if you have more than one _ 

disk drive. This approach is discussed in the next section. 



USING THE COPY PROGRAM 

Those of you with one disk drive will have co LOAD, then SAVE, programs 
one by one onto the diskettes you use for back-up copies of programs. 
Those of you with two drives can use the COPY prcgr;in, or tha Syeten 
Haster diskette, to copy the entire contcntu of your currmt programming 
diskette Onto your back-up diskette. The COPY program requires thee both 
disk drives must be connected to the same dl*R controller card, to prevent 
overstraining the power supply. 

In the COPY program, the diskette from which copying La done is called 
the "original*" The vntire contents of the source diskette will be 
ropied onto a "duplicate" diskette. The "duplicate" diskette does not 
have to be INITiallied before being copied onto, in fact, uny previous 
information that was on the "duplicate" diskette will be erased. 

Before copying the "original" diskette, it's s good idea to wrlte-protecl 
it* Then you can't accidentally erase its contents, even if you put it 

lnl a I In- wrung ilr 1 '.■■■. 

As default values, the program assumes that the "origin*!" diskette will 

be placed in the currently selected drive (the drive from which you ran 
COPY), connected to the controller card In the currently selected slot. 
To use the default slot or drive number for the "original" dlakett*, |uri 
press the RETURN key when the program expects you to type a mimher. If 
■i default in wrung for the "original" diskette In your ayvcera* you 
i In- i-orri-i i iiniTilii-r when It's requested by the program. 



3S 



a 
a 



When you havo specified the slot and drive numbers tot the "original" 
dlak*tc«, the COPY program talla you where the "duplicate" diskette- must 
be placed- It will go In the remuiuLng drive controlled from the sane 
Blot which yau specified fur the "original". 

Here's on example of using the COPY program with the default slot and 
drive numbers. It assunes your two dl*k drives ere connected to a disk 
controller card in slot lit. 

1> Place the Syatem Haatcr diskette in drive I. Type 
RUN COPY 
and after the usual whirring you Ahould Bee 



■ 

2) Remove the System Master dlukette from drive I and then insert the 
original diskette, froa which you wish to copy. Into drive 1 

(did you remember to wrlte-pmtect your original?) • 

3) Nov press the RETURN key to Indicate you want to uaa the default 
slot number, iilot tb In our exnaple, for the original diskette 
Next you'll see 

and again press the BETVRH key to indicate you want the default 
drive nuober, drive 1 In our example, for the original diskette. 

W\ Now you will see 

API 

I 



oPiGitm. s; 












Dftl 










pr: 











:'E THEN 
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Insert the "duplicate" dlskr-i ii>, onto which you wish to place the 
back-up copy, into the drive specified for It: drive 2, in this 
i- sample. To stop the program at any response, use the traditional 
CTRL-C 

5) Finally, to begin copying, press the RETURN key. 



If the message 

occurs when you try to copy a diskette, thcra in no diskriti- in the 
"duplicate" disk drive. The message 






Indicates a problem with tha "duplicate" diskette or the drive containing 

it- If the dl&kecte has a tab over its wrlte-protect notch, no 

information can be put onto the diskette until the tab is removed. 

© 

In other situations, DOS will report an 

I/O ERROR 

if a diskette is Inserted improperly or if the drive door is left open, 

but the COPY program will tell you (incorrectly) that the diskette la 

wrlce - arotected . 



$ 



If you do not have a second disk drive connected, you will be given the 
Incorrect message that the "duplicate" is writc-prutcctcd . 

Tha ocas ag* 



Indicates a problem with the "original" diskette or the drive containing 
lc. Perhaps the diskette has been clobbered, or perhaps there's no 
diskette in the drlv. 

$ 

Whan the program asks 

DO VOU WISH TO MHKE HMOTHEP 

answer with Y for YES, or N for HO, and press the RETURN key. Do not 
type more than one character before prawlog RKTUHN. 

If you try to use a printer with the COPY program, you'll find weird 
displays both on the TV screen and on the printer- 
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DEBUGGING: MON AND NOMON 

The process of trying to get a program to run the way you want it to ia 
called "debugging;" program errors are often referred to as "bugs"* All 
diyk commands «nd all Information sent between the cainpuU-r anil the dink 
are normally not displayed on the screen. But when you're debugging, 
monitoring this information can help you track down problems. 

The HON command allows you to MOHitor a variety of information! To turn 
various parts of the display off again, use the NOMON (HO NONitor) 

comma iid . 

Thrca different parameters Chut noy be uocd Ln tli ■?,<■ ctimnutnda; 
C stands for Commands to the disk (such as OPEK, READ, etc) 
I Stands for Jtapul froal tin- dlaV (when Kt'.AUIng it file) 

stands for Output to the disk (when WHITE ing a file). 

These parameters are used only with the NOMON And MON commands. Usually 

NOMON C,I,0 is la effect: no BOnUoring Is taking place. 

Tin- syntax for the commands is 

HON [C] |,1] t,0] 
NOMON [C] [, I] [,0] 

At least one of the three parameters must be present with the NOHON and 
MON commands, else the command will be Ignored. The parameters nay appear 
In . iriy order and, as usual, must be uepar.-itrd by rom&AS. 

There are 7 different ways in which the MON command may be used; 
command what it monitors 

HOS C Commands to the disk 

HON I Input from the disk 

HON Output to the disk 

HON 1,11 Input from und Output to the. disk 

HON C.l Commands to and Input from the disk 

MON C.O Commands to and Output to the disk 

MON C,I,0 Commands to, Input from, and Output to the disk 

To Illustrate hov the command works, a sample program called TEST MON la 
included on tin- Syntew Master dlakeiie. Tn try out the prograB, place Che 
System .'taster in your drive and type 
LOAD TEST MON 

then SAVE che program on a diskette that's not write-protected. Now ROB 
the program. A list of options will be presented to you. Kneli tine you 
select en option che program will put material Into a dlBk file and also 
retrieve material from a disk file. (Llrtas IBB through 18fJ create a tent 
i Lie SAMPLE containing 3 numbers and 2 strings j lines 200 through 270 
retrieve the file SAMPLE.) Try out oil the options: notice what kind of 
information is displayed for each possible rmnhlnntion of parameters. 

*** NOTE *** 

A MON command remains in effect until a 
NOMOK, INT, or TB (firmware only) command in encountered 

or 

mil -It you bout the system 

or 
do a restart ODBC). 
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n nr.-ii trick* yuu un lwaue a HUH command and Later cancel It without 
affecting the screen forrat — e»cn I he NOMOK does not show on the screen. 

Suppose you execute a T50H comauurl, flay 
HON C. I. a 

To cancel the command without hiving It print on the screen, include 
PRINT n$; "NOMOK C,l,0"t VTAH PEEK(37): CALL -868 
where D5« as usual, contains CTKl.-n. 



MAXFILES 

DOS allows up to 16 files, to be active (in use) at one time. DOS deals. 
with several types of files In addition to thai BASIC program file* 

discussed so far. See Chapter 6 for s discussion of sequential text 
files, Chapter 8 for random-access text files, and Chapter 9 for the DOS 

coamands used vilh binnry Im.i.btru' Language) files. 

The MAXFILES command specifies how many active files are peraltted. When 

yon limit DOS, the etisatnnd 

HAXFILES 3 

is executed, which sets up the default condition: a maximum of 3 files may 

he active ulnwl laneously iml ( ] tool ln-r MAXFILES OOBUaad In executed. 

Tie command's syntax is 

HAXFILES n 

where n must be an Integer from 1 to lb. Specifying a value outside thi?» 

range will cause ■ 5YKTAX ERROR message from either Applesoft or Inlrgrr 

BASIC; from the Monitor, a beep is the only Indication that you've done 

something wrong. 

For *aeh f 11* specified, HAXFILES aacs aside 595 bytes of memory space 
called a file buffer. This additional memory space for each active fila 
la uaad to help adjust for the fact that memory speed is far fester than 

disk access speed, which involves mechanical motion — th* disk head has 
to search the diskette. So In the name of efficiency, a file buffer is 
used to "buffer" Information going to and from a diskette. 

If you retrieve information from a diskette, DOS brings In 256 characters 
at a time and puts them in th? "input" part of the file buffer, than 
delivers to you whatever subset of those 256 characters your program 
requested. If you are sending information to a diskette, characters arc 
stored in the "output" part of the file buffer until 256 characters have 
accumulated, then they're uhlpped to the diskette all at once. 

Suppose you. have MAXFILES I and one file io active. An attempt to perform 
a DOS command (such as CATALOG) will cause the message 
SO BUFFERS AVA11J.BI.E 
to be displayed. 

When the system is booted, the number of active filea (n) defaults to 3, 
so 1785 bytes of memory are reserved for 3 file buff era. Under most 
circumstances, you won't need more thsn 3 active files. If more files arc 
required, type 

MAXFILES n 

(uliiTi- U lO th' 1 mjB*i.T of nin-riiil (ili-n) In (nimi-dinle execution node 

before loading and running a program. 
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In lamed late execution made, Increasing MAXFILES erases Integer BASIC 
pEDimn rod Hdsu pp AppicsMti ;'.-]'■/:. ? . t - > ■ - 1 ■ HlKBHi ■ fcwwd sfivn 
without moving the program or Strings- To avoid thia problen, reset 
MAXFILES before loading and running a program. 



If MAXFILES 19 used within a. program, It changes neaury pointers, and A 

GOTO, GOBI'S, or other instruct Ion cim fiat lost. If you must change 

MAXFILES from within an AppU-uufi program, make the MAXFILES command the 

first statement in tha program, before any string variables are declared. 

For example, 

14 PRINT CUES(4}; "MAXFILES 5" 

20 REM REST OF PROGRAM GOES UERE 

To use MAXFTI.F.S from within an Integer BASIC program, you need to create 
an EXEC file, as discussed on page 78. 



TRACE 

The Applesoft TRACE command is a useful debugging I mil . But when TRACE la 

in effect, DOS coamtindfl Inside Applesoft programs don't work because TRACK 

prints the line number with no RETURN before the DOS corawmd. There** a 

partial solution to tin- problem. You can inaert a RETURN ( CHKSC13) ) 

into the DS Vilring 

10 f)S • c:HRS(ll) + CHRS('i) 

and then most D05 commands wl!l work properly even if TRACE is in effect. 
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If TRACK is in effect when DOS (with the DS fix, above) is WRITEing. alJ 
the TRACEd line numbers will be printed into your text file along with the 
characters yon wl-jhed (n print. 



USING THE UPDATE PROGRAM 

As discussed In Chapter 2, INIT Is used to create glam diskettes. In 
this section you'll learn how to create master diskettes. The distinction 
between a glove ond a master is not readily apparent: both come charmingly 
attired in the latest in block plastic (no, not leather 1 ) garb. It's up 
to you to revise your greeting program and diskette label to Madrid 
youruHt which la slave and which is Baster. 

The SyatOP Master diskette contains a prograa called UPDATE l«S that can 
run on on Apple II with at least 16K oE denary • The UKPATK program does 
the following for youl 

* "Updates" a previously INITIallzed diskette to DOS version 3.2 
without affecting program or data files that ore already stored 
on chat diskette* 
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* Converts a slave diskette (whose DOS Is memory-size dependent J 

loCO a manU-r diskette (whose DOS is self-relocating so that 
memory la used efficiently on any size system). 

* Gives the updated diskette a new greycing program luae, the name 
DOS will attempt to RUK each tine the diskette is booted. 

The UPDATE 3.2 program must be used with ■ diskette that has already bean 
OH Tin Used. It will not worlc with • diskette that la wrlcs-protecced. 

Here's on example of how to UPDATE the diskette ISITialiied in Chapter 2 
(the one with the ONE TO TKN program on It) to convert the slave diskette 
created by ISIT Into a master diskette. For convenience, that diskette 
will be referred to as diskette OHR in the discussion that follows. 

Before using UPDATE 1.2, do the following: 

I ) Insert the diskette you wlah co update — diskette ONE for this 
example — into the disk drive and RON the diskette's greeting 

progran — named HELLO on diskette ONE. The message displayed by 
a greeting program should include the version of DOS used to 
initialise the diskette, nnd its status as slave or master. 

2) Change the appropriate lines of the greeting program to display the new 
information. "HASTEB DISKETTE UPDATED TO DOS VERSION 3.2". Then SAVE 
this new version of the greeting program. If the diskette's outside 

label requires, a HlmLlnr change, make that change now. 

3) Note fin- name ol the greeting program. If you wish the updated 
diskette co RUN this same progran each time it is booted, just ns li 
did before updating, you will give this greeting program nane to the 
UPDATE 3.2 program, later on. If you've always wEnhed thai your 
greeting program had some other name than Its present one, RENAME 
the greeting program! nnw. Later, you will give the new name to 

the UPDATE 3.2 progran. 

To use UPDATE 1.1, do the following: 

4) Put the System Master diskette In the drive, boot P05 . and 
from either BASIC type 

BBUN UPDATE J,3 

5) Vou should see the message 

DOS 3.2 MRSTER - JTZLTTV 

"9 BY APPLE 

nu. pi 

6) You'll then be cold to cype Che greeting program name 
to be used by the updated diskette: 

PLEASE INPUT THE 
FIL 
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We'll assume chat when you SAVEd the revised greeting program 

on diskette OWE (step 3, above), you used the nam* HF.LLO. So type 

HELLO 

unless you wish the diskette to RUN some other program name each 

time the diskette is booted. When you press the RF.TURN key In HEM 

the greeting program name, you II see this massage: 

• HE '•&■ . JT IN 

THIS IS THE FiLt ' 
:CED I-IIIHIII 

HEl 

PLACE THE DISKETTE TO BE »Uf IN 

FffESS f ESC 1 



A) Follow the instructions, Remove the System Master diskette from the 
disk drive and replace it with the diskette you wish to update ■ — 
diskette ONE, in this case. Finally, press the RETURN key to begin 
updating; the program will inform you when the proeCM i?" complete. 

•>) After using the UPDATE 3.2 program, always re-hoot DOS 
before doing any other work. 



*»* Bote *** 
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Tin' greeting program name that you give to the UPDATE 3,2 program is not 

.1 in the diskette's CATALOG. It Just tells the diskette's uos which 
program none t« 808 etch time the diskette is hooted. You must make 
sure that the diskette's CATALOG actually contains a program bearing the 
Hums name you give to the UTDATf. 3. 2 program. 

If you forget to do so (by skipping atcp 3, above), you'll see the message 

FII.K SOT FOUND 

eacn time you boot the disk using this diskette. 



*** Reminder *** 

You must remember the name of the greeting program lor each diskette. 

You can make this pretty simple by using the name greeting program name on 

all of your diskettes. 
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TEXT FILES: AN INTRODUCTION 

Sometimes you'll want to use the disk to score information chat Is not a 

program. You nay, for exanple, wish co keep copies of correspondence, a 

list of words used in a vord-guessing game. Intermediate results of a « 

calculation, or a mailing list. A text flic , sometimes called a datn 

file will allow you to do this and nore. The letter T narks text files 

In the CATALOG directory. 

Text filea Are created and retrieved using DOS commands in an Integer _ 

BASIC or Applesoft program. A text file nay be created using a program 

written In one language and retrieved Iron a diskette using ■ program 

written In another Language. >•* 

Most sample programs in this manual are in Applesoft* If you wish to 
convert the programs to Integer BASIC, recall that In Integer BASIC you 
can't make string arrays and you nuat DlHensior. string variables. In an 
Integer BASIC command such as 
INPUT AS, BS, C$ 

only RKTUHNm (not comma) my M-partite the three responses. This, manual 
doeB not tell you how to cake each program run In Integer RASini ee* Lhe 
Appendix M of the Applesoft II BASIC Pronraoaing Reference Manual for 
details of converting between languages. For some hints, about changing 
the BASIC in which a program runs, after, the progran has been written, 

see page 7fi of tills DOS manual. 

The DOS inmmaiiils LOAD and RUN (also BLOAD and BftL'N ) may not be used with a 
text file. An attempt to do so will cauC4 the message 
FILE TYPE HISHATCH 

to appear. LOAD and RUN expect a BASIC program file (and BLOA" nnd HKlin 

expect u Binary mochlne-lnngiuige file), not a text file. Instead, you 

Bual vr 1 1 ■!• programs that send data to a text file and retrieve data Iron ti 

cexc file, using the DOS cocmands discussed in thla chaptcn 

OPEN 

CLOSE 

BEAD 

WRITK 

APPEHTl 

POSITION 

EXEC 

The commands OPEN, READ, WHITE, APPEND and POSITIOB r.-.mioi he used in 
immediate-execution mode- If you try to do so, you'll receive the message 
KOT DIRECT COMMAND 

These commands must be used in deferrc-rt-exneution mode, that is, from 
within program. The commands CLOSE and EXEC moy lie used. In 
Icimedlnte-cxccutlon mode. 

In addition to the commands listed above, the DOS commando. 

LOCK nnd UNLOCK 

DELETE 

RENAME 

HON and *B©« 

VERIFY 

CATA1.00 

work with text files iii the same way they work with program nlea. 



do 



There are two different types of text fllrvn Mt-qiiuntlal text Ellea and 
random-access text files- Both types of Inl fil« store ntrlngs of: ASCII 
codes to represent the data, but In different formats. Diagrams of the 
two text-file types arc uhovn belou (Etta. :i 1.1. ii-r } represents the 
RETURN character, seat automatically at the end of most PRINT statements). 

"PICTURE" OF A SEQUENTIAL TEXT FtlF 

■star* \7 \} [a |t |> |n |n |e |» |H |i. |u |w |> | | | | | [ | ] 

ASCII: | 35| 13jib5 |S4| 13| 79| ?K| b')\ 1 3 1 bt. | 7b | If [8 / 1 I j|j»g | M \ ft | W| flfl | g(l j0fl] 

File Byte: 1 2 3 4 5 6 7 6 9 10 11 12 13 14 15 16 17 18 19 20 

Field: 



"PICTURE" OF A RANDOM-ACCESS TEXT FILE 
( Example: Record Length 5, One Field per Record ) 



Cham si 


1 


> 








A It 1 » 1 lo In Ie 


i 




ft 


% 


o iw 


* 1 1 


ASCII: 




55|l3|(J0|jl0|#(l|65|84|ll|00|00|?'»|7a|6fl|n|0(l|6G|76|79|fl7|13|0a| 



File Byte: 1 Z 3 4 5 6 7 8 9 10 II 12 13 14 15 IS 17 18 19 20 

Record Byte: 01234012340123401234(9 

Field: 

Record: 



The teres "field" and "record" will be discussed in Chapters 6, 7 and B. 
The comsands OPEN, CLOSE, READ, WRITE and POSITION are used with both 
types of files, but in somewhat different ways. Sequential text fllea are 
simpler to use and understand, In sone reBpccts, so vc will discuss the 
use and structure of sequential text files first. The use ot 
random-access text files la described in Chapter B. Sore detailed and 
technical information about all types of files can be found in Appendix C. 



SEQUENTIAL TEXT FILES: SOME EXAMPLES 

Suppose you want to make a file containing, a list of words to be used In a 

vord-guesainR game. Here are two pairs of programs that deal with such a 
rtlr. Tlie first program In each polr crcetcs a text file on the diskette. 
The second program In each pair retrieves the data stored in the text 
file from the diskette. 

This program creates a text file named V0RDS1, containing the words APPLE, 
BAHAMA, CATALOG, DORMANT, EAGLE, FRUIT, GOOSE, HAT and ICICLE. 
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REn CTFL-C *m 

39 PRINT Dl 

PRINT — 

60 ^ 

70 PRINT "CFiTHLO. 
;'JT "PORIIHf 

100 PRINT "FRUIT" 

no print n 

14f "* 

a 

Line 30 OPERs Che file i usinR the norniBl format for bending u WIS CODBUnd 

from within a BASTC program. OPEN places a text File nnnrd WORIl.Sl in the mm 

CATALOG (If U v*8 not there previously). 

Line itf's WRITE command causes subsequent output iron l'Ki'; ; -nentfi to 

be seat to the named text tile Instead of to the TV screen. So in this 
program, i-n.-h FKlNi ;.i hi i-mi'ii I in liui't. 50 through 130 will fiend the word 
inside the quotation marks to the text I lie WIKOS I , .uul DOC to the TV 

screen. 



Line 140 CLOSEs the I lie, and ends the file-writing prrirruH. 
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If the program is RUN and you're not In MONlcor mode you won't nee 

anything: usually DOS commands and disk Input and output arc not 

displayed. But if, as explained in Chapter 5, you type 

HON C. 1. 

(or simply 

MOK C. n 

Mime no input from the disk is involved) and then you RON the above 

progrnp you' 11 oec the fotiowinftl 

3 

flPPl 

-OG ^ 

IHKT 

EflGIX tm 

"■ 

HHT 

■ 

a 
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At tlil re point, you'll have d file culled WORDS! an your diskette. wiifillS I 
will be marked with a "T" In the CATALDC! to Indicate that it's a text 
file. The file consists ot items of data (In this case, vords^ separated 
by RETURNS. A RETURN character 1* automatically sent at the end of every 
PRINT statement which does not end with a coram] or a semicolon. Noli" I li.it 
In this sense each RETURN is a character rather than an action — in 
particular. It is the character with ASCII code 13. 

Earli 1 1 ini of data, ending with Its RETURN character. Is called a field . 
A Held is stored in the text file no a scries of charactars tepres*nt<ld 
by their ASCII codes. The last character in each field must be the RETURN 
character, ASCII code 13. 

H0RD51 i» called a sequential text file because each field Is stored 
beginning Immediately after the RETURN character of the preceding field. 
When stored an the diskette, fields nay be of different lengths: the word 
APPLE takes 6 bytes (one for each latter plus one for the RETURN 
character), BA.NAKA takes 7 bytes, and so on. A sequential text file la 
•.Lured on the diskette as one long, continuous series of ASCII-coded 
characters, a chain of field* with no gaps left between then. 

Once WORDS I Is on the diskette, the question immediately arises, "How rnn 
I retrieve it?" The following Appletiolt prngram ulll reirleVr WtWDSl: 

REM RETRIEVE WOP 
2B 0* - -" REM 
30 PRJ EN UORDSJ 

■ 
50 FOR I - i 7 

70 NEXT ! 
8© PR 11 
30 

Line Ifl OrlSs th« file; line 40 tells TOS that all subsequent INPUT or GET 
statements will refer CO the named diskette file instead of the Apple's 
keyboard. It la as If the disk were typing responses, Instead of you. An 
INPUT command always causes one complete field , ending with its RETURN 
character, to be "typed in" to the Apple. If another IKPUT cownnnd 
follows, It will cause the next field to be read in, and so on. So 
lines 50 through 70 cause DOS to atart at the beginning of W0RDS1 and 
retrieve 9 fields which urn placed In II.. array ASU). AS(2), AS!' , 
ASCI, ••• A$(9). Line fifl politely CLOSEs the file. 

If MM C, I, is not in effect when the above program is RUN, you will 
see nothing an your screen. Rut if HON C, 1, {or Just HON C, I) is In 
effect, you'll ■■■■'■ 

READ WW 
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2 

7EH5L 

IT •-» 

_ 
CLE ■■*' 

A question mark C ? > la diaplayed before each INPUT from the disk, Jt»l 
as il is before each normal keyboard INPUT. 



To check that all worked an claimed, try typing 

PRINT AS(2), AS{9), A5 C4 1 

mid you should see the words HAKAKA — from AS (9) — then ICICLE and 

finally DORMANT. This Is a good vay to check that information was read 

correctly- 



If you modify the program HAKE UftRUKl In make different words, be: Sure to 
DELETE WOKDSl before re-RUNnlng HAKK WORDS 1- If foe don't, you may end up 

with a. mixture of the old words and the new. 



3 
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Here's how to create a sequential file called W0Rns2 containing the same 
words as WORDS I, but with all nine word* in one field. Each word la 
followed by a comma , i.o that an INPUT statement with multiple variables 
(9, In this case) can be used to retricvi the separate words. 

■S = ""■ REM Zl 

■ 
PRINT £>*; "WRITE U 
50 PRXMT " fPPLl. 

— ' 
DORMANT. EAGLE ™ 

a 

76 PRINT " GOOSE- HOT, ICICU ■"■ 

80 I t- "CLOSE MO _ 

90 END •-- 



Note that the PRINT command in Line 50 nids with a semi-colon. A 
nenl-colon at the end of a PRIST command stops the automatic print Itir nf a 
KKTIIKN character after the last data character. Therefore the characters 
sent to ihi- dink by the neatt PRINT coamand will appear In the same 
field with the characters sent by line 50's print rnmannd. The PRIST 
command in line 69 bIso ends with a sera I -colon, so the field Mill does 
not have its end-marking RETURN character- Line ?ff's PRINT coeanand enda 
vlthout a scnl-colon or roam, allowing the automatic final RETURN 
character to he sent at lost- Thin ends the field, which now contains all 
the characters PRINTed by lines '><t, 60 and 70- 



a 
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Commas In a disk-less PRINT command usually Bend characters to defined 
cab-fields on the screen. However, commas do not serve this sane 
formatting function in PRINT commands used when WRlTElng to the diukt 
these commas are treated as If they were semi-colons. In FKlTiTlng to the 

disk., Items separated by comas will be concatenated. Kith no intervening 

spaces inserted. A coonui at the end of a PRINT cnnmuind has the ASM 
effect as a Bemi-colon: no automatic final RETURN character is sen!. 

When the program MAKE W0RDS2 is RUN with KOH C, I, In effect, you'll see 

OPEN U0RDS2 
WRITE W0RDS2 

•i. DORMANT. EAGLE. 
FRUIT, GOKl ICICLE 

DS2 

This Applesoft pragma retrieves WORP52: 

ift REM RETRIEVE W0RDS2 

20 M - ■'" RBI CTRL-0 

36 PRINT D*. "OP?-- 

40 PRINT Di; "READ WORD- 

50 i. A4*. A5*, ft&* 

• ■ 

Winn the above program Is RUN with HON C, 1, O in effect, you'll nee 

OPEN M0ROS2 

READ M0RDS2 

? APPLE. BRMRNfr. CflTflLOa DORMANT, EOGLE 

, FRUIT, GOOSb 

In Integer BASIC, comws con oeporatc multiple INPUT responses for 
numeric variables, but not for Btrlng variables. Only RETURN 
characters can separate multiple responses when INPUT Is used with 
multiple string variables. In Integer BASIC, therefore, the program 

KKTRIKVK UQRDS2 ulll .!•-■. I >;■. I In- entire fli-lil (t words, 8 rrnun and 6 
spaces) to the variable Al$. Then you will get the END OF DATA message 
when there Is no field to assign AZ5. 

In Applesoft BASIC, you can also use the GET command to retrieve data from 
a text file, character by character. This has the advantage that you can 

define any character as marking the end-of-word, for instance. The 

following Applesoft program also retrieves: the text file W0RDS2. 

in linn 10, (hi: Cl.KAK iiimiiiJ aeln nil variables (including I and all 
A$0)'») to koto, l-inc 20 hups Applesoft's alternate way ol setting 13$ to 
CTRL-D {4 is. the ASCII code for CTRU-D). This method avoids the Invisible 
(And uii-copynhle) control character. 
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101 GET l 

PS - CHR* <4V REM CTRL-0 

tM RET: 

«? --ft 

■ 
70 I - 1 

90 IF fts - 

100 ir Bf = R* TH 

• B* 

PRINT T-T. H»CI> 
120 GOTO 80 

130 PRINT ftSi Of. "CLOSE WORT 
140 



Line 30 GETs one character at a tine from the text file UOBDS2, which was 
OPEKed for READing In lines 50 and 60. tf the new character lfi neither a 
comma nor a RETURN, line 110 Adds the new character to the end of the 
string A$<I). Then line 120 sends the program hack to line 80, Co GET the 
nest character! ThtiB, the program builds up the first word, character by 
character, in A5fl). 



3 
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When a comma in round tin first word is ended, so line 90 sends the 

program back to line 70 to increment I and atart collecting a new word in 

AS (2). And bo on. Finally, a RETURN character (R$) marks the end of the 

field, so line lfl(* -.iinh, i In- ps ryrum en to line ! 30 to CLOSE the file ond 

end the (iroRnin. Note the use of CHR5(13), in line 30- You cannot 

directly type a RETURN character into a BASIC program line (a typed mm , 

RETURN ends a program line), but C1IRS<!3> la a RETURN character in 

Applesoft . 

When <:et obtalnn characters from the disk, these characters arc not 
displayed on che screen, even in HON C, 1,0 mode. Line 95 has been added 
to let you see the words aa they are built up, character by character . 
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After an Applesoft GET command takes its reaponae from a diskette text 
file, the following problems arise: 

1) With KOMON C,I,0 the Eirat character PRINTed after the GET 
will not appear on the scraan. 

2) With HON C,I,0 the first character PRINTed after the GET 
•"ill appear on the screen. 

3) In either mode, if a DOS command is the first item PRINTed 
aEter the GET, the T>0S comnaml may not he enecuted hi'r.ui^i- 
the necessary preceding RETURN is Biasing. 
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In the program GET VORD52. the non-printing "throw-away" character CTRL -A 
(T$) wao placed before the first desired PRINT character In line 115. 
Thlii t.lki'H en re DJ problem I and 2, above. To cure problem i, I In- XKTUftN 
character (RS) was placed before the PRINTed DOS comnatid In line 119, Much 
as waa dona with TRACE (see page 44) i 

When this program is RUN with HON C. 1, in effect, you will sea the 

following (but all displayed in one column, not three): — 
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D 








1WP 


MX 


GOO 


HPPL 


DOf 






OOP 

DORMAN 




B 




H 


BO 




HA 




E 




BfVIH 


FA 




BflNftfJ 


EflG 


I 


BfiNRNH 


EftGL 






EAGLE 


ICI 










r 


ICICL 












CLOSE IJ0RD52 




• 













And Lastly, herd's an Applesoft program 1 1, i rrcvili-ti n file WORDS 3, with Z 

worda in th* first field, i words In the second field, and 4 words in the 
i lil rJ Held. 

RETI MHKE WOf ' 
20 DJ - CUR* <*:>; REM CTRL-D 
38 PRINT 0*i 
40 PRINT D*i "WRITE WORD 

TJ8- 
.<G, OORHRNT, EHGLfc " 

PRINT "FRUIT. GOOSE. MOT ■ ICI'. 
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"CLOSE WOROS3" 



The first field will contain 

APPLE, BAKANA 

and fs 13 bytes long, *in<- pit 

one for the RETURN character. 

CATALOG , DORMANT , EAGLE 

Is 22 bytes long,; the third field, 

FRUIT. GOOSE, HAT .ICICLE 

la 23 bytes long. 



Imrjictor (ecinaiiB muBt be counted too) plus 
The second field. 
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When RUN with HON C» 1, In effect you'll see 

OPEN WORK3 

HRITE M0R0S3 

APPLE. BRIOTNR 

OTTHLOQ. DORMANT, ER6LE 

LE 

Here's a program to retrieve WORDS 3 » 

10 fl-FM RFTRiF'/F UOROSi 
20 D* = (• REM CTRl 

30 PRINT Df; "DPEfJ WORDS3" 
40 PRINT D*. "READ W0RDS3" 
50 INPUT R*,S* 
68 INPUT T*.U*, 

INPUT W*.X*. Y*,25 
so PRIM1 i 

END 

When RUN with HON C, I, a In effect, you'll see the following; 

OPEN WORDS.* 
READ UORI 
DAPPLE. BANANA 

rlTALOU- I 
''FRUIT, GO'' 
■ 

The programs to READ ch« sequential texc files WORDS 1. WORDS2. WORB53 were 
carefully designed In KKAH exactly the correct number of field* and the 

correct number of items per field. In general, a program to retrieve a 
text file must be designed around the specific file. If you make a 
mistake, the results can appear somewhat confusing* For instance, 

conaider the following "wrong" program to retrieve the words in text file 

Harass. 

10 REM RETRIEVE WORDS: 

40 PRINT D*J "REND MORK 

£8 INPUT T*, U*. VI 
80 PRINT D*; 
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Willi HON C, I, Din effect., here's what you would sea on KUHnlng the 
pi i!>',tam. 

OPEN WORT. 

REFlt- HDRDS3 

WPlF 

TCflTPLOO, DORMANT, EHQLS 

CLOSE UOFl 

The INPUT coanuand In line 70 roused the entire field containing 
FRUIT.GOQSE.UAT, ICICLE 

to he Read into the Apple. The first three wards were assigned to the 
variable! W$, XS and Y$i But chert, it no variable corresponding to the 

fourth INPUT response, ICICLE, so the message 

EXTRA IGNORHll 

Is displayed, and execution continues. 

Here Is another "wrong"' program to READ the text file WORDSJ: 

39 PRINT 

PPINT 

M INPUT 

60 INPUT T»,II*.VJ 
70 IHPU 

■-E HORO 

And her* la a HON C, I, RUN of the program. 

[ 

•tNfi 

QQSEj HOT. ICICLE 
7EX! 

END OF Dfr 

This time, lint- 60 caused the field 
CATALOG .DORMANT , EAGLE 

to- b* ReAC into the Apple. The three words are assigned to the variables. 
T$, U5 and V5. But Una 6B"a INPUT command expected lour responses, so 
1 1 causes the Malt complete field to be READ Into the Apple: 
FRUIT, GOOSE. HAT. ICICLE 

The first word, FRUIT, Is assigned to lint- 6(1' b last variable, VS. There 
at* no more variables with this INPUT command , bo the message 

EXTRA 1CN0RED 
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iii displayed, and execution continues. There are no more fields In the 

file, so line 70's INPUT coBBfind causes the 

END OF DATA 

message, and Che program comes to a stop. 

a naejettafl ■art general peii si pro gTaM > HAKE nXT ™i RETRIEVE rgjn ate 

discussed In a Inter section. They Illustrate how to make .1 program more 
adaptable to different text tiles. 



3 
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OPEN- IMG AND CLOSE-ING SEQUENTIAL FILES 

Sequential text tiles should be used when information is to be retrieved 

In a linear fashion from the beginning to Che end of the file, and when ^ 

Information does not require »uch updating or on-going revision* For 

example, a sequential file could be used to contain data for a 

word-guessing game, as in the preceding sample programs. ^*> 

To create a sequential text file, the commands 

open -^ 

WRITE ^ 

PRINT 

CLOSE 

are used, In the order shown (though not necessarily right after each 

other). To retrieve a sequential text file, the coamands 

open 

READ 

INPUT 

CLOSE 

are used, again in the order shown though not necessarily right after each 

richer. Both procedures arc i 1 luutrnted In the preceding section. 

A certain rituol fs required before and after you create (WRITE) a 
sequential text Ellei before n»lng the rile you must OPES it. When you're 
done, you must CLOSE it. The same is true when retrieving (READirig) a 
eequentieJ teal Elloi OPEIi before READing, and CLOSE the file when you're 
done- 
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Files that have been OPENed must be CLOSEd. Failure to CLOSE n file that 
u«s OPXMed and written to by a WRITE coomand may result In loas of data. 

The syntax for these commands is sinllor to other DOS conaandv. 

I Notes OPEN and CLOSE are also used with random- nee cub files — see 

Chapter R.] 

OPEN f I,Ss] I .Ml [.Vvl 
CLOSE [f| 

Examples: OPEN SESAME 

OPEN SHOP, 112, S7 

CLOSE 

CLOSE MOUTHED 

CLOSE WINDOW 
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OPEN iocs aside workspace in the Apple for Che file f (for those who know 
About each Staff, OPES allocate* • '>95-bytc file bull it t» handle this 
file's input and output), and gets the system ready to read or write Irom 
the beginning ,,f tin- file. OPEN «1bo sets up the slot and drive nuabara 

to be used by the subsequent WRITE <or READ} command. 

The CLOSE command releases tha workspace In the Apple (de-allocates Un- 
file buffer associated with the file f). If f la not specified, ail OPEN 

i I Ley will be closed, wLth the exception of any file being, used by the 

EXEC command. EXEC EU« are discussed later in Chapter 7. OPEN 
sonetiaea CLOSEa too: OPEN first checks to aee If the naaed file Is 
already OPEN; if bo, It CLOSES it before re-OPEMtig it. 

Kote that the CLOSE cnmwsnd has no Drive or Slot parameters. If you type 
CLOSE HrFILE 

then any file named MY KILE will be CLOSEd, regardless of the alot and 
drive number mitmcintcd with the file- Similarly, the command 
CLOSE 

will CLOSE all files (except a file being EXECed) on all disk drives. 
In VStlOUS circumstances, you nay wish to delete a file f that may or mny 
not exist. Thla la especially Important to avoid problems of overwriting 
an old file (unless you overwrite the entire old file, part of the old 
file will remain, attached to the end Of your new file). Suppose a game 
creates and uses the flic SCORES each time It Is. played, and you wish your 
program to delete any old file by that name at the start of each new game. 
Tha command 

DELETE SCORES 

will cause the error message 

FILE SOT FOUND 

If tin- file doesn't exist, and your program will halt. Hcre'n a quick way 

to delete any file named SCORES and re-OPEK It for new data, whether or 

not that file already exists: 

3 PEN SCORES DELETE 

-0 
15 PRINT M. "OPEN SCORES" 
20 PRINT Or- -DELETE 500* 
25 PRINT &»i "OPEN SCORE 

REPIftMl 

HERE 



WRITE-ING SEQUENTIAL FILES 

Here is another program which creates a sequential text file. This 
Applesoft program createn a teat flip named SAMPLE which contains 3 

strings and 10 numbers. 

The file SAMPLE may or may not already exiat each tine the program is RUN: 
if it does exist, it should be DBIKTKd no nn to remove old data from the 
file. If It does not_ i:xi'.n mul v-mr [■riij.-.ram tries to DELETE It, you'll 
receive Che message 
FILE HOT FOUND 
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end the program will stop- Lines 29 and 30 take care of the problem. H 
SAMPLE already exists, line 20 OPENs it and line 30 DELETES it- If SAMPLE 
does not exist, line 20 creates a file SAMPLE and line 30 DELETES it. 
When line 40 la executed It creates a clean new file SAMPLE, so the 
probleo of nixed files Is avoided- 

5 HtH Bf p^ 

10 | • REM CTRL-D M 

EN SftMPLe" 
30 PRINT r>*. "DELETE SRMPLE" 
40 PRINT 0*> "OPEN SWFLE'' 

PRINT ft. "WRITE SflflPLE" 
6© PRINT "HI N 

88 FOR J 

90 PRINT J — 

:T J »■ 

lie ps ,_ 

120 END 3 

HiMi-'u uhat you sec on the screen when you RUN this prograa, If HON C. I, _ 

is in effect. >— 

OPEN SAMPLE 

FLE 

OPEN 9 ■ 

WRITE SRMPLE — 

HI HO H 

HO *" J 

■ 

■ 

CLOSE SflMPLE ^ 

Before you WRITE a file. It oust be OPENcdi CL08B It (quietly, pltan) 
when you're done. Both the OPEN and WRITE conewnda must refer to the sane 
1 1 It.- UM( 

One* a WRITE command is executed, nny nibM^Weot PRINT concinds send all 
riiaracters to the diskette. Instead of the screen. A WRITE command is 
cancelled by the use of ony DOS ii>nmuiud In a PRlttT stataaant. Even the 
"•■pcy" DOS command (just CTRl-fl) will do- 
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An INPUT command of the form 

INPUT X$ 

■ ihin CHOCOla n WKITK cutnnuind, but only alter staring as the last text file 

character Che ? which the INPUT command nornuilly displays on the screen. 

if in. (arm 

INPUT "WHAT'S YOUR NAME? "; XS 

Is used, the WHITE la i.iiurlri! after the characters in the string axe sent 

to the diskette. 
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An error Bessage Cancels a WRITE command, but only after the entire 
error message is stored ai the last field in your text file. 



The syntax for the WRITE command whan used with sequential files is; 

WRITE I 

IKote: WHITE la also used with random-access files, see Chapter S.I 

Examples : WRITE LETTER 
WRITE RIGHT 



The sanple proRrnm given "• the beginning of this section Is a simple 
i 1 lustrnt inn nf the anal bugle (BASIC?) eleacnts needed to create a text 
file. A slightly more general Applesoft program called MAKE TEXT la on 
the System Master diskette that caoe with your disk drive. 

HAKE TEXT allows you to create a sequential text file containing up to l(M 
strings; each string nay have at most 239 characters. Try it — you'll 
like it {ve hope). Piece the System Master diskette In your drive and 
type 

LOAD MAKE TRXT 

A LlSTing of the program should look like thla: 

r. > ■ 

10 DIM m - 

20 M 

40 PRINT -'THIS PROGRAM I 

FILE;. 
5© Ff 

Kj AT fl TIME. 

39 CHfiROCTr 

) + 1 
80 PRINT "(JQ QUIT, PHES RN 

9c- ;tring ■ 



C ContLnued on next pugc > 
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(Continued trora previous page) 

188 INPtn 

1 
FIRS 

RETtJ 
PRINT 

I 

in 
U* 
PRINT 
170 PRTNT D*: -MRTTE "iM* 
180 PRINT F - I 
190 FCF: J«ITO I - J 

220 PRINT [ 

OnC* the program 1b IJ)Allfd T SAVE il iin a ditski-tte Iluit'fi mil 
write-protected. (This step is necessary because this program, Llkr llir 

A51MAT.fi program discussed In Chapter *. creates a new file.) 

Is HAKE TEXT -it i 1 1 in y.nir Appl.-? And .1 non-ur I IB-protected dink In the 

drive? If bo, type 

HON C, I, 

so you can sea the commands sent to and from the dlBk. Then type BUN 

and you should see th* following message: 

YOU GET TO TYPE ONE STR11 TIME 

fl STRING linv HfiVE UP TO s 

<T0 OUIT. PRESS RETURN KEV FIRS 

rvpE »i. 

Type in as many seringa as you like (up to 1(10 may be entered). 
'■■'virn Inx t tin' program u*ir>A INPUT, bo don't type commas or colons into 
your strings. When you wish to quit, Just prCM th« RETURN key instead of 
typing a string. You'll ba asked 

HURT FILE NRt!! 

Choose a name for your text file, preaa the RETURN' key, and as your 

Strings are Rent to the disk you'll Bee them printed on tha screen. First 

will appear the disk commandy 

OPEN f 

DELETE f 

OPEN f 

WRITE f 

(where the t la replaced by the file name you chose). They'll be Eellomd 

by a number — tha number of strings you entered Into the flic. (Thfo 
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uuaber will be used by ■ program dlpeussed In the next section that 
retrieves your file). Next you'll see your strings. Finally you'll see 
the message 
CLOSE f 

Here's S sample RUN of the HAKE TEXt program: 
THIS PROGRAM LETS VOU WRI 

ill GET TO TVPE QrC 

R STRING. MrrV HOVE UP TO 235 



DUJT, PRESS RETURN KEV FIK 
TVPE STRING H HERE'S STRING 

: 
TVPE STRING i2 AND MV 5ECOM 

CTG QUIT. PRESS RETURN KEV Fir 
TVPE STRING 

RETURN 
TVPE STRING »4 ENOUGH ALREOl 

(TO QUIT, PRESS RETURN KEV FH 

- 

HHfiT FILE N 
OPEN TEST 

rEST 

URITE TEST 

4 

AND WV SECOND STRING 
ON Ml 

ENOU 

: 
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If you OPEN a text file th.it already exists And thee WRITE to It (without 
first DELETElng the llle and te-OKESing It), tliL-n you will overwrite at 
least a portion of the file. Unless you overwrite at least as many 
characters as existed In the old file, the result is that the new file 
contents will be a nix of the dm u PHI ST Ad to the file on the two 
occasions. First will appear the new characters you PRiNTed to tba Eilo 
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this time, and then will follow any portion of the old file you did not 
overwrite. To clear all characters fro* the old file, OPEN and DELETE the 
old file before you OPEN It anew, (In the program MAKE TEXT, lines I Ml 
and 158 take care of "cleaning out" any previous text file by the same 
name.) To keep programs from overwriting a file, LOCK tno flic 



READ-ING SEQUENTIAL FILES 

Tin- DOS cooffidnd HEAD a 11 owe. you to retrieve .1 text file. Once a BEAD is 
executed, any subsequent INPUT statements Cor GET a in Applesoft) refer to 
the specified file Instead of the Apple's keyboard. Thia Applesoft 
■., :• r .111. ivliipvfi tin- text file 5AMFLS IIUMll bv t'.i- pCOgrBB listed ll 
the beginning, of the preceding sect ion. READ, like WRITE, Bust be 
preceded by OPENlng the file to be used. The tile must be Cl-OSF.d an well. 

3 REM RETRII LE 

10 D> = CHR* <4); REM CHJM 
CTRL-D 

29 PHIK 

30 PRINT &t> "HEW SW1PLE" 
48 IMPUT R*. 6* 

59 FOR I 10 

Ct M 

Tfl NEXT 1 
PRINT 

An OPES must precede a READ, and an INPUT (or, in Applesoft, a GET) muut 
follow a BEAU. The open nnii READ must refer to the sanit file name* If 
you RUN the program with WON C. I, o in effect you'll see this; 

REflD SAMPLE 

■>H1 

110 
PF TO THF I (30 

71 
72 

76 

79 

CLOSE SAMPLE 

The proRram was written explicitly with the SAHPLE file in mind: It 
assumes that the text file contains 3 strings, (AS, B$, and C$ in line 49) 
and IB integers (W In Una 60). Two question sacks are printed when BS 
and CS .-ire INPUT because RETURNS separated the input's multiple responses. 
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A REAR command In cancel led by the use of any DOS command In a PRINT 
statement. The "empty" DOS command (just CTRL-n) will do Just flue. Use 
of the PR# or \W commands elso cancels a read. 



The syntax for the READ conrimnd lu Ihe eomi- an for WR1TF.1 

READ t 

[Wni>-: k£AD Is Also used with random-access files, aee Chapter 8. 1 

Ennoplca: READ LETTER 

READ CAREFULLY 



Stopping a READ In Applesoft using CTRl.-C will generate a string of 
REEKTERs. To avoid this, praai the RESET key to atop the program. 

An Applesoft program that retrieves text files created by the MAKE TEXT 
program 1b an the System Hastet diskette. Plate the System Haater 
diskette ltv your drive and type 
LOAD RETRIEVE TEXT 

then SAVE the program on the same diskette you used for MAKE TEXT. (The 
program is really a companion piece to MAKE TEXT, and It's simply non- 
convenient to have them on the sane diskette.) 

A LISTiiiR of the program should appear a9 follows: 

5 REM RETRIEVE" TEXT 

20 HOME PRINT "THIS FRCGKflM 

leves text fiu 
33 print "created bv the make t 

48 PRINT '■MOnt C, I. IS IN EFFECT 

SO PRINT 

60 INPUT "NHrlE OF TE 
J 
PRINT I*. "I 0" 

80 PRINT 
SG PRINT £>*, -OPfc 

iee print Mj "ffh[' • 
* i 
Din fw 

140 INPIT 

PRINT C«*. "CL0S 
178 PRJNi 
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Now type 

RUN 

and you should see the message 

THIS PROGRAM RETRIEVES TEXT FI! 
CREATED BV THE ■ MfiKE TEXT' PROGRAM. 
HON C, 1,0 1% IN EFFE 

MFIME OF TEXT FILL 

Type In the name of the text file you created using the HAKE TEXT program. 
Iiress the RETURN key, and you should be off and running (oops — rather, 
KKAtling}. 

Hpre'n what you'll See If the file TEST, lined an a sample at the end of 
the last section, is retrieved using the RETRIEVE TEXT program: 

TH 

CREATED BV THE 'MfiKE TEXT' PROG 1 - 
HON 

nhpif of rea file 

OPS 

secono sro 

TON HE DO 

■iQUQH ALREHDV! 
tSE TEST 
HOrtON G, I» o 



MORE ON SEQUENTIAL FILES: APPEND AND POSITION 

The DOS conaands APPE8D and POSITION, respectively, allow you to add text 
to the end of a sequential text file, and to tieo-tiu ml urination from any 
specified field within a text file. 

APPEND allowy you to add data to the end of a sequential text file. 
This Is particularly useful if you wish to extend the Informal ion In a 
sequential teitt file, as in the ANIMALS program dlficti&aed In Chapter A 
could hive. The command OPEN, you will recall, nlwaya sets the 
put. 1 1 lan-In-the-file pointer to byte 9. the first character in the f i l ■• - 
The coBoand APPEHD performs an OPEN for you on a file that already 
exists, then sets the posilion-ln-tho— f lie pointer to one byte beyond the 
l.'tAt character in the file. 
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The following prrtftrom biiiidr. a file called TESTER that contains the two 
strings "TEST 0" and "TEST I": 
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<tm iester 

D$ - CHR* <.4> REM CTRL-0 

29 PRINT D#; "OPEN TESTER" 

30 PRINT OS, "DELETE 

48 PP "OPEN TESTER" 

50 PRINT D*j "WRITE TEST 

7© PRINT "TEST 1" 

8© PR I NT iSE TESTER" 

The following program APPEND* the strings "TEST 2", "TEST 3" and "TEST V 
to the tile TESTER: 

5 REM APPEND TESTE* 
10 D* = CHK t ' -n R£n 

I ER" 
30 PRI 1RITE TESTER" 

40 PRIN1 ' 

w win r j~ 

60 r 4" 

79 PRINT I ISE TESTER" 

The (allnwlnR progrna dliipUjIn the file TESTKK: 

10 RETT RETRIEVE TESTER 

_-D 
print 0* "OPEN TESTER" 

40 PRINT 

50 FOR I = 1 TO 5 

60 fl* 

70 NEXT I 

8© PRirjr 

APPEND must be followed by WRITE (Attempting to READ will just cause the 
END OF DATA moRsage). The Syntax for the APPEND COBOand Is doubtless 
Jiimfllfir II ynu've been reading straight through tills manual: 
APPEND t I.Sal f ,Dd! I.Vv] 

APPEND, even though it Is used only for MJtlTEing into a text file, doea 

not cause the 

FILE LOCKED 

message if the file is locked. That message is given only if you attempt 

to actually WRITE to the flic- 

The WIS command POSITION allows you to WRITE or READ Information beginning 

in any given field of a sequential text file. The syntax for the POSITION 

coanand 1b 

POSITION t I.RpI 

whore Rp Is the Relative-field Do*icion> This command specifies that 

DOS F a posit ion— in— the— file pointer will be moved forward (only) to the 

p— th field ahead of the current pointer position. If p*0> the following 

READ or WRITE begino In the current field. If p-1 , the following BEAD or 

WRITE skips the current field and beg in* In the next field. If p"2, the 
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Hollowing READ or WRITE skips two fields Including Che current field, 

be fori- beginning to READ or WRITE- And so on. It your file does not 

contain any field corresponding to the relative-field position specified 

by the POSITION command, the message 

END OF DATA 

will be displayed, and prograo execution will stop, 

POSITION with the Rp parameter specifies a relative field position, p 
fields ahead of the current field. POSITION Bust refer to a file that you 
have already OPESed* OPEN automatically sets the position-ln-the-file 
pointer back to the beginning of the first field. Thus, if POSITION is 
used immediately after OPEN, the relative -field position also 
corresponds to the actual , or absolute, field position- In no other 
case is this true. 
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Like any other DOS comnand, POSITION cancels a READ or a VRITR. Therefore 
POSITION must be used before the associated READ or WRITE. 

n 

P05IT0N Actually scans the contents of the file, byte by byte, looking for 
the Rp-th RETURN character. If, during this process, it encounters an 

"emply" (value (8) byte, I hi- » iy.- 

END Or DATA 

l» presented lmaedlacelv . It is not necessary to actually INPUT or GET m ^ 

any such null character. 

Here is a program that uses POSITION to retrieve various fields from the 
TESTER file, created earlier by the HAKE TE5TER nnd APPENT> TESTER 
programys 

REM POSITIO!. * - 

26 D* » CHR* <4J: REM _ 

IPtff (tt _ 

70 rRlHT 0*j "POSITION r t" 

80 PRINT D*; "REDD TESTt 

■ 

"OPEN I. 
110 PRINT Of ^ 

120 PI — « 

PR" 
If you RUN this program with HON C, I, in effect, you «i I I - - •■■: 

■ rrj TC"' 

UON TESTE ^ 

BEAU- TESTER t— 

POSIT] ■"* 
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HERD n 
OPEN TESTED 

READ TESTER 
'TEST 4 

Are you surprised ot ttic results? Remember that the current field Is 
relative-field position number 0. Abu, tiWikT that each INPUT causes 
am- field to be READ Into the Apple, and advances the 
ijiisit ion-in-thc-f lie pointer to the beginning of the next field. 



BYTE-iNG OF MORE 

Nate: the following section Is not for beginners, sod sequential flits 
con be used perfectly veil without a knowledge of the parameters dlacussed 

li. : i . 

The DOS rumAiidA WHITE and READ can be used with a Byte parameter to 
WRITE or READ Information starting from any place in a text file — JJ[ 
you know where that place Is, The trick involves knowing at exactly which 
byte In the file you want to start (each byte contains one character's 

ASCII code)- To do this, you must know exactly how you have stored 
information Into the file. You must count all RETUHKb, commas, uyiarrti and 

other characters In the Elle when tlgurinx out where to begin- The 
problem is even more difficult for WRITE, because you oust also know where 
to end. 

The a parameter la an actual or absolute position in the file unless R is 
specified. If R is given, the B parameter is the actual position within 
the Specified field . 

The command 

WRITE THISKONTH, 827 

sets the positlon-ln~the-f lie pointer to the twenty-eighth byte of the 

file named THI5H0NTH (tin Elrsl byt* L> number 0). Characters Bent to the 

disk by s subsequent PRINT command will replace Hn equal number of 

characters thai olrendy existed In the file, beginning with the character 

in the 28th byte- 
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This over-writing 1b not confined to the i-urn-nt field. If yrni PKIKT 
fewer than the number of characters remaining in the currant field, you 
will create two new fields: the field you Just FRlKTed, followed by the 
toll-end of the field you were over-writing. If you PRINT nor* than the 
number of characters remaining in the current field, you will over-write 
some of the characters at the start of the next field: the current field 
will then be lc/fiRer, and the next field shorter than before. 
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It Is also possible to WRITE Into bytea thai arc beyond tlur last byte- of 

an existing sequential text file. An attempt to READ the Intervening 
un-written bytes will cause the 
END OF DATA 

oesfiitftf- to )'<■ displayed, and yuur program will utnp. Sec the discussion 
Of READ Willi the ft pnnimi-U'r , for Information on accessing sequential text 
fill' f it- Ids that are mil next to each other. 

The syntax for thla command Is 
WRITE f I .3b] 

where the B parometer spec Hies the file byte at which characters sent by 
the next PKIHT comeiand will begin replacing file characters. Tha default 
value of b is 0, the first byte In a file. Byte b la an actual , or 
absolute, position within the file. The B parameter may specify a 
position either before or after the current pcsition-ln-the-f lie pointer. 
[Note: this command Is also used with random-access files. See Chapter 8.1 

Siallarly, the command 

READ LASTMOKTU, B32 

Mi;t» the posit imi-in-the-f lie pointer to the thirty-third byte of the flic 

■miked LASTMUX'tH (again, I Im- I I ml livlr i :. niinhi-r i\. A uubscqui-nt INPUT 

commend will cause all characters In the next field (I.e. up to the next 

RETURN character), beginning with the character whose ASCII coda Is stored 

In the file's 33rd byte, to be READ Into the Apple. If the 33rd byte does 

not contain the first character of a field, only the remaining characters 

in that field will ba READ, «, 

Syntax for this command Is 

REAll f 1,8b] 

where the B parameter specifies the file byte where the next INPUT or GET 

command Will begin reading characters. The default value of b is V, the 
first byte In a file- Byte b is an actual , or absolute, position within 
the file. The B parameter may specify a position either before or after 
the currant poslilon-in-tha-f lie pointer. I Note: thla command U also 
used with random-access (lies, see Chapter &• I 



REM M rtTR 

L-D 
PRINT ESTER" 

~E rESTI 

<l? PRINT "HI 

30 PRINT I ER" 

With HON C, 1, In effect. RUN RETRIEVE TESTER to Bee how the previous 
program has changed the file TESTER. As you can see, the field containing 
APPLE COMPUTER has completely overwritten the fields that contained TEST 
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The following program sett tha post tlon-io-the-f lie pointer to byte 14 

{the fifteenth byte) in Tile TESTER, whU-h wan rn< il rarllrr hy tin- 

program MAKE TESTKK. Tln-n II HRIXBa the string "APPLE COHPOTBR", Note — , 

the familiar sequence: OPEN, then WRITE and PRINT, and finally CLOSE. 



z 
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} it ml TEST A, aa well as Che first character of the field chat contained 
TEST i- As there are now only tour fields In oil, the EN II OK IIATA nrsugr 
Wei displayed after the fifth TNK11T 'command. 

Hie lollciwing program Sets a pointer to byte IB In the file TESTER, Just 
nod 11 led by the preceding priigram. then this program KEADft in the next 
RETURN in the file. Again the familiar format: OPEH is followed by READ, 
in -i i-i>ini- INPUT AlatoDontn (or. In A]>(>leAof t, GEIs may be used) And 
finally the file Is CLOSEd. 

VTE READER 

£8 PF OPEN TESTER" 

3S PRINT CJ, "REflD TESfEP. B18" 

40 INPUT fl* 

58 PRINT OS; "CLOSE TESTER" 

Try ea predict what you will Bee, before you RUN this program. 
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CHAPTER i" 

AUTO APPLE 



Controlling Lhe Apple via a Text File; EXEC 
75 Creating an EXEC Fi 

Capturing Programs in a Text File 

Clog Machine-Language Routines to BASIC 

MAXFILES and Integer BASH: Programs 
78 EXECutive Session 



To better understand the contents of this chapter, it is 9ugg.c8.ted that 
you first read Chapter 6, on sequential text files- 

CONTROLLING THE APPLE VIA A TEXT FILE: EXEC 

The DOS command EXEC ifl similar to HUN, except chat the disk file used by 
an EXEC command is a text file that contains conmandB or nrogr.-im lines, 
including BASIC statements, as If they were typed at the keyboard. 

To initiate a demonstration of some EXEC cumndrul abilities, 

LOAD EXEC DEMO 

from your System Master diskette anil I h.-n BATE It on a diskette that's not 

write-protected. Leave the un-wrice-protected diskette in tin- drive, 
since the progran HKITRh a text file. 

Next RUN ihe prograea. Ytiu should see the message 

THIS PROGRAM CREATES ENTIHL TEXT 

FU tVERAL 

STRINGS. EACH A LEGAL APPLE II COI1M 
WHC rVPE 

FE- 
THEN THE COMMHNPS IN FJ 

VOIR COMPUTER EACH COMMAND 
MILL BE EXECUTEX- JUST AS IF IT Hfl 
TVPEO AT THE KEVeriftRT) THF : HL 

DESCRIBES THE PHI BORE DETAIL 

« HAPPV EXECUTING 
PRESS THE SPACE BAR TO MR] 
PROGRAM CREATE THE FILE 
IF VOU WISH TO STOP THIS PR'. 
YOU MAY PRESS THc ESC KEY 

Press the Apple's apace bar, and after a brief peuue y«u should see the 

dink drive's IN USK light come on as the program writeB the DO'F.R fllu 

oiitu the diskette. Noti type 

EXEC DO 'E(l 

press the RETURK key. Your Apple will begin a solo performance based on 

the script In the DO'EK file. 

Hate's o brief nummary of the major things OO'ER does: 

First TO'ER Issues a HOK C, I, command, so you'll be able 

to see what happens. 
Second, a three-line program is written and saved on diskette 

under the name NEW PROGRAM! ! The prngrna If then LISTed. 
Now a FOR-KEXT loop is. executed co take up some time, so 

you j?_i«t si chance to look at the screen before the 

activity continues. 
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Next OO'ER uses the INT command to enter Integer BASIC, 
LOADS the program COLOR DEHOS, and LISTa It. 

At tbia point, DO'ER uaea CALL -155 to enter the Monitor and 

executes aooe machine-language instructions before using 

the FP command to eater Applesoft. 
Fran Applesoft e HON C,I,0 command I :; executed, then 

HEW PROGRAM!! Is RUN, modified. Listed (again a FOR 

loop allows yoj to take a look at the screen) and SAVEd 

using the name F.VF.K MORE RECENT PROGRAM! I 
Lastly, the program NEW PROG RAMI I Is DELETED and the CATALOG 

(including the new addition EVEN MORE RECENT PROGRAM; !) 

Is displayed. 
And you won't even have to lay a finger on the keyboard (unless your 

CATALOG has more than 18 entries, In uliirh cane you need to pree* the 
apace bar to see the balance of the CATALOG entries). 

CREATING AN EXEC FILE 

Ftere'a a acep by seep example to lltuscraee how to create on BBC file 

noacNJ DOIT that contains the fnl lowing commands: 

LIST 2(1, S|# 

RUN AWAY 

CATALOG 

Flrac create and SAVE an Applesoft program called AWAY to use In the above 
demonstrnt I mi I 

5 REM 8U«V 

le print 'HtPN mm with ru« bv 
"J" 

Host write and SAVE the following program, called MAKE EXEC, chat will 
create a text file called DOIT. Vhen you Inter EXEC DOIT, the conmdnda 
your HAKE EXEC program has PRINTed into the DOIT text flic will toll Apple 
to RUN the AWAY program for you. Notice that the commands' which are 
PRINTed into the DOIT flic, for later EXEClng, are not preceded by a 
CTRL-D. 

MflKF EXEC 
10 D* = CHRf OK CHPJ'4' IS 

20 N DOIT" 

30 PRINT M "WRITE r-OIT" 
40 PRINT "L!- 

PRINT "RUN RW 

?0 PRINT D*» "CLOSE POIT" 
After you have MAKE EXEC and AVAY both SAVEd on a diskette-, type tne 

CCrmmmUnd 

RUN MAKE EXEC 

to CCCetC JJ aequcntial text flip iiJiimi-fli TTOIT- 



75 



Type the command 
EXEC DOIT 

to cause the commands in the file DOIT to be executed one by one, Just as 
if they'd been typed In from the keyboard. Again, notice that the 
commands now being EXECuted were not preceded by a CTRL-D In the program 
HAKE EXEC, First lines 211 through 50 from the program currently tn memory 
(probably the program MAKE RXKC) arc Listed. Then the program named 
"AWAY" Is RUN, and finally the CATALOG on the diskette is displayed. 

CAPTURING PROGRAMS IN A TEXT FILE 

Here's a far more useful example of using the EXEC conmand: it allows you 

to capture program listings ua tent files, Such a program enn be used fnr 

* translating Integer BASIC programs into Applesoft 

* renumbering pares of programs and EXEC trig them anywhere 

into another program 

* inserting favorite subroutines into programs from a 
subroutine file on the diskette by EXEClng the file 

* "appending" one pragma to another 

* repairing programs that have become partially unreadable 
(you can capture the good portion In .1 text file, re-hoot, 
then EXEC the program portion hack into memory) 

Tha line numbers 2274 and 51 30, following the LIST command in line 6 of 
the CAPTURE program, should be replaced by the line numbers of the program 

In memory that you wlsli to capture. The name of the sequential text file 
containing tha listing is LISTING-. 

1 rem capture 

2 d* = chr* h ctrl-d 

3 PftI' 

4 PRINT D*; "WRITE LISTING'' 
I 

G LIST 2279,5130 

7 NO" 

8 TEXT 



Me made the line numbers of this program very close together, so that you 
can add these lines to a program already in memory, or anywhere within 
your program that you huv<; eight tree line numbers- You could Just as 
easily put all the lines of CAPTURE above the highest numbered line in 
your program. 
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CAPTURE creates a text file containing commands that are preceded by line _ 

numbers. When you EXEC that text file, the numbered commands will pot be 

executed. Instead. Just as if you had typed those lines in from the 

keyboard, the lines ere stored as a program In Apple's* memory. Onri' 

captured in e text file, a program can be modified end then EXECed hack 

into Apple's memory. Unlike IAAI) or RUN, EXEC docs not delete a program 

that is already in memory. Using CAPTURE, you can capture a program in a 

text rile from one language, then EXEC the program back into another 

Language (of course, the. program may not run without some changes — wmm 

there's somewhat different syntax for Integer BASIC and Applesoft). You 



76 



can also use EXEC thin May t<3 add new i Inaa tu an MlnlliiR pcngram In 

memory* In fact, you can save a Hating of CAPTURE in a text file named 
LIST SAVER, say. and than EXEC LIST SAVER any time you wanted to add the 
CAPTURE program to a program in memory. 

CONVERTING MACHINE-LANGUAGE 
ROUTINES TO BASIC 

Here's another useful program that will take a machine-language routine 
and convert it into a BASIC program portion which POKE* the 

machine-language routine into memory. The program portion can be used as 
part of either an Applesoft sr an Integer BASIC program, to put the 

■ulch I ne- language routine Into Memory each time the BASIC program is run- 

5 REM CODE-POKES WRITER 

lti L>i ' B.-0 

15 PRINT D*i "OPEN CODE-POKES" 

28 fKirji D*j "DbLfcTb COOE-POl 

25 PRINT D*; "OPEN CODE-POKE 

30 PRINT t>*> "WRITE CODE -POKES* 

48 LINEWUMi U08 

50 FOR PLACE = 768 TO 783 

60 COUNTFP JTSX + 1 

70 IF COUNTER - 10 THEM COUNTER - 

1 
80 IF COUNTER < > 1 THEN 1 
98 PtfINT 

IB PRINT LINEMUMBER;- 
J-ii.-" LINENUMBER = LINENUMBER + i 
1M PRINT " P| RCF.".-'. PEEK 

<PLBCE 

PI.RCE 
135 PRINT 

t>#, "CLOSE CODE-POKES" 
15e END 

When you ua* this program, the number In line 40 should hi* changed to 
contain the line number of your BASIC program where the POKElng program 
portion is to start. The FOR loop In line 50 should contain the starting 
and ending decimal memory locations of the machine-language routine you 
wish to convert. 

Once you've typed in the program. RUNnlng it will create the text file 

CODE-POKES . Now use the command 

EXEC CO&E-POKES 

to place your ■nachlne-liingungi— POKElng pragma portion into any other 

program, beginning at the line number previously specified. The program 

CODE-POKES WRITER will work with either Applesoft or Integer BASIC. 
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MAXFILES AND INTEGER BASIC PROGRAMS 

An EXEC file Bust he used If you want to increase HAXFlLES from Inside an 

Integer BASIC program without erasing your program. Here's how, Use Che 
procedures described above to create an EXEC file, let's call it FILE. EX. 
The file FILE. EX should set HIMEM below the area th.it wilt be taken by the 
I m- reused MAXFILES (595 bytes per additional file), than delete the pare 
of the program chat causes execution of the EXEC file. 

FII.F..F.X should contain the following commands to .-illow for 5 filed on a 

48K. system: 

CLR 

HIMEM: -2S326 

DEI. 10 .20 

RUN 

As shown in Table 2 of Appendix D, DOS usually nets HIMEM for n 48K nystem 
to -27136; to allow fot 2 mote W byte buffers than usual, HIHKM must be 

aut to -27136 - (2 » 595) or -2832$. 

The first lines of the program would be as follows; note that whit appears 
us CTRL-D ia created by holding down tin- k*y mirked CTRL while typing the 
Lai i ax D. 

18 FRIKT "CTBL-D EXEC FILE. EX" 

20 END 

30 PRIKT "CTRL-D HAXFII.Kft 5" 



EXEC-UTIVE SESSION 

The usual syntax for the EXEC command is pan 

EXEC f ■■ 

where f is the name of a sequential cexc file containing BASIC commands or 

program linen. Exanples of this usage appear throughout the earlier 

sections of this chapter. EXEC with chls syntax causes the first field cl 

file f co be read into che Apple as if it were being typed on the __ - 

keyboard. When che first field's RETURN characcer Is "typed"", the Apple 

Attempts to execute the field's contents as a BASIC command, or enter the 

M-.-ld's contents as a BAStC progras line- The type of BASIC (Integer "i 

Applesoft) is not changed by EXEC unless the file contains an FF or IKT 

coamand. When execution has ceased on the first field, Che Second field 

of file f if. read into Che Apple and treated similarly. The acclon cornea 

•i. ,i ettnp when the last field of file f has been read. 

The EXEC command cannot be stopped by CTRL-C. 

Only one EXEC file can be OPEN at any one time- If you are EXECing a 
file, and one of che conoand* thus executed is another EXEC command, che 

first EXEC file is immediately CLOSEd. Thereafter, It is the Second 
EXEC command that is being execuced. 

ir a file being EXECed contains a command co RUN any program, EXEC will 
wait patiently until the progrnoi endO- Then the next EXEC file ronnand 
wll ] be eawevl 'd. 
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However, it 1 program is R mining while an EXEC file is OPEN, any IWPUT 
statement In the program will take the next field in the file being KXEOd 
as itfi response, ignoring the keyboard- Worse yet, if that response Is an 
imaediate-execut Ion DOS command, tile command will be executed before the 
program continues. Results can be very confusing. 
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If you interrupt a RUNnlng, Applesoft program by typing CTKL-C while an 
EXEC tile is OPEN, the reminder of the BXBC tile will usually not be 
executed. 

If any 'field of an EXEC file cSdAOt be interpreted as a valid BASIC 

command or program line, the message 

SYNTAX ERROR 

Is generated, and the next field Is read Into the Apple. Thua , you can 

EXEC any. text file, whether nr nut II contains BASIC statements (flrat 

be sure you've SAVEd any pragrnin In im-imiryj. En MOM C t 1, mode, this 

can provide a crude but handy tool for quickly examining the contents of a 
text file. 

The EXEC conmand can also be used with the Relative-field position 
parameter, In a way that la a bit different from POSITION'S use of that 
parameter. The syntax for thia use la 
EXEC f I, Up I 

where Rp specifies that file f is to be EXEC'd starting in the p-th field 
of file f. Since EXEC always sets the position-ln-the-file pointer to the 
firm ehar.uiir ul the file, oo I hi- parameter Rp always Indicates the p-th 
i iiid rotative to the file's hu gjnnlng . Thus p always corresponds to 
tin- file's actual , or absolute, field. H(S indicates that EXECing begins 
with the file's first field. HI indicates EXKRIng begins with the second 
field, etc. 

© 

Note that this is different fron POSITION'S use of the R parameter, 
where K3 Is o relative field only, itnd may Indicate different actual 
I Mr lli-lda at different times in n program. 
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EXEC HYFILE, Rf 

generates an 

END OF DATA 

message If the K parameter r.peei f ies the second field beyond the file* 

end. (If the first field beyond the file's end Is specified, nothing 

happens). 
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CHAPTER 

USING RANDOM-ACCESS 

FILES 



Random-Access Files: How They Work 
A Specific Record 

' iple Records 
A Demonstration: The RANDOM Program 
WRlTEing and READing Random-Access Files 



For a better understanding of the information presented In this chapter, 
it is suggested that you first read Chapter 6, on Sequential files. 



RANDOM-ACCESS FILES: HOW THEY WORK 

Random-access text fllra are like a collection of equal-sized cells in • 
honeycomb -- some colli may be full, others nay be eopty. Each "cell" is 
called a record ■ When you create a random-access file, you oust specify 

the standard size tor the records the file 18 10 com ."i in. 

Unlike the fields in sequential files, which may be of almost any Length, 
the records in a random-access file are of specified fixed length . file 
first tine you WRITE to eny particular record in a file, enough space la 
set aside on the diskette for a complete, standard-length record, whether 
or not the record is actually filled. So random-access files don't 
necessarily represent an efficient use of space- However, since those 
files are set up in such a regular fashion, it's fast and easy to retrieve 
or modify Information from any part of the file — hence the naoe 
"random-access" file- 

Random— accesB files should be used in applications* requiring fast access 

to various parts of the file, or whore individual pieces of information in 
the file need to he changed fairly often. Far example, a random-access 
file is particularly suitable for maintaining a Bulling list. 

Random-access files are created and retrieved in a Dinner very similar to 
chat used for sequential files. The main difference is chat certain 
commands have additional parameters i OPEN requires no I. (Length of record) 
parameter, while READ and WRITE each use an R (Record number) parameter. 
Soae sample programs will be presented and discussed before getting into 
detaila on creating and retrieving random-access files and how the new 
parametern work. Horc technical information about random-access text 
files nay be found in Appendix C. 



A SPECIFIC RECORD 

How can you access a specific record In a random-access file? The, 
following pair of Applesoft program illustrates how DOS allows you to do 
this. The first program requests a name {N5J, a telephone number (P$) and 
a tip code (ZSi , then sends them to record 1 of a file colled MAILER: 

10 RBI MfiKE MAILER 

20 Of m CMRf dv RE ■ -O 

"NAME: "Jl» 

iNPtn "Phi i ' p* 

50 INPUT "ZIP CODE ", Z# 

68' PRINT 0*i "OPE" MR] >30" 

70 PRINT D*J "WRITE rffllLEF, M." 

'J I N« PRINT PS: PRINT Zi 

» PRINT I -HILER" 
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Line 20 place* a CTRL-D In the variable D$, as usual. 
LlneA 30 through 5^ request the information to be stored* 

Do not type any commas or colon* in your responses ■ 
Line 63 OPENS a file called MAILER, with 200-byte long records. 
Line 70 prepares Few recording infornuit imi in record I. 

Line 80 «ends N$, PS and ZS to the diskette — since record I una 
specified In line 70, all three pieces of Information 
are recorded in record 1, separated by RETURNS. 

Line 90 Ci.OSSs the file. 



With HON C, 1, in affect, when the program Is RUN you'll sect 

NAME AMY DOflKS 

-•HCWE . 

2 IP CODE: 95014 

open mhti fp. i ?ee 
hrite iiniLER 

t4Z'5> 355-1010 

.14 
CLOSE MAIL 

Record I of the tile MAILER can be retrieved by thia projraDi: 

10 REM KETmhVfc I1H 

20 D* = CHR* (4i REM CTRL.-D 

30 PRINT D*> "OPEN NrtlLEi- 

40 PRINT D*; "REflO NAILER. Rl " 

INPUT Nl«. PI*. Zl* 
78 PRINT Dfc "CLOSE MAILER" 

When RUM with HOM C. I. 0, you'll sec the following. As usual, the pair 
of question narks indicates en INPUT with more than one response. 

OPEN MAILER, LZO0 
REAP MfllLEi- 

42b > 555-1 h 
?>33014 
CLOSE Mrt.Lth' 

And here is a slightly different program to retrieve record 1 of MAILER. 

IB REM RETRIEVE MAILER.B 

20 t>S = "••_ RE. itS CONTAIN 

CTBI -r> 
30 PRINT D*> "OPEN MH1LER^L200" 
40 PRINT D*. "REfiD MB II FR. R1" 
50 INPUT Nl* 
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68 INPUT PI* 

78 INPUT . 

88 PRINT DS; "CLOSE MAILER" 

98 END 



MULTIPLE RECORDS 

a 

The program that created the randoa-access file MAILER wrote to a single 

record In the file, saving, three different pieces of Informtition separated _ 

by RETURNS- The next program demonstrates writing to several records: In 

particular, record numbers 12 through 15 of a random-ace*** flit called 

RA-FILE. 

5 RErt MRKE RH-F1LE " - 

18 D* s CHft* f4) : REM CTRL-0 _ 

28 PRINT D$, "OPEN Rff-FIl *■»* 

20 PRTNT M; "DELETE RR-FII.E" ^ 

40 PRINT D*, " 

30 FOR I = 12 TO 15 

60 PRINT D*j "WRITE RA-FILE. ft- 

70 TRIMT "WHE fiDpRESS ". I 

«e::t i 
98 print ds; "write rr-fil& r13" 

100 PRINT -oris VERSION - m 

110 PRINT D*J "CLOSE RA-FIlE" 

Line 10 sets DS to CTRL-D. ■» 

Lines 20 and 30 nuke sure RA-flLE la a new file •-* 

Line 40 OPENa the file RA-FH.K, whose records will each be 
30 bytes in length. 

Lines 50 through 80 create a loop that WRITES the Information 

NAHE ADDRESS _ 

followed by the record Dumber, for records 12 through IS 

Note that you must specify each record in a new WRITE 

coamand. before having PRINT Bend characters to that 

record. 
UaM 90 and 100 change the Information In record 13 to the 

text given in line 100's PRINT command. 
tine 110 CLOSES the random-access file KA-FILB. 

a 

If MOH C.I.O is In effect when the progran is RUN, you'll see the 

following: m* 

M-f 1 LE 

DELETE Rfi-FILE _ 

OPEN Pfl-FILE- L30 ta- 

WRITE ftfi-FIL- 

NOME flCDRESS XZ 

WRITE Rft-FILE. Hi.3 

wira: oppress Q 

1RJTE RH-FILE, R14 

NOME RDDRES5 14 ■ 



84 



WRITE Rft-FJLE. R13 
NAME ADDRESS 
WRITE PR-FILE, RA3 
DOS VERSION 3 

CLOSE Rrt FILE 

In a simil.tr fashion, you can BEAD information from a selected record or 
records of a text file- The next prograo retrieves records 12 through 15 
of the flic called RA-FILE, trying, on line 60, to find which record (s) 
contains the lectin "DOS" as the first three characters. 

5 REM RETRIEVE Rfl riLE 
10 i : REM UTRL-O 

20 ~PRINT D I RA-FILE. L30" 

J8 FOR J = 12 TO 
40 PR'NT D*: "READ RA-FILE 
50 INPUT H* 

60 IF LEFU hN 

PRINT "RECORD ": J; " WAS CHA 
•J. ■ 
NEXT J 
80 PRINT C*> "CLC>: ILE" 

Line 10 (eta up CTRL-fl in US. 

Line 2d opens the te« file RA-FILE, whose records are 30-byces 
long (that's what we specified when the file was 

created In an earlier program, remember?). 

Lines 30 through 70 READ records 12 through IS of RA-FILE. 

Kote that you Bust specify each record In A flew READ 
command, before a subsequent INPUT will read characters 
from that record. In line 50. each record coned In from 
Che disk as an ASCII string cernlnated by a RETURN- 
Lint- 60 checks the i leftmost characters of the INPUT 
string AS from record r, to sec If the word "DOS" In 
there. If It 1b, the message "RECORD r WAS CHANGED." 
1* printed and the Search continues. 
Line 80 closes the file. 

Here's what you'll see when you RUN the program, if MM C, I, is in 

effect: 

OPEN Rfl-FILE, L30 
READ RA-FILE' R3? 
7WIME ROORESC 
READ RA-FILE. 
rDOS VERS I On 2,2 

13 MRS CHANGED. 
READ RA-FT 
7NOME ADDRESS 14 
READ RA-P 1 1 
THAME ADDRESS 15 
CLOSE RA-F 
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Hotlce that when the file uoo retrieved only records that had been written 
to were examined. If you had asked for record $ In RA-FILE, you would 
have received the 
END OF DATA 

message, since no informer. Ion had been urltrf-n to chat record of Eh* file. 
Siinl Lilly , hud you tried to INPUT norc than one field from any of the 

existing records you would have been Riven the sane message: each of 
records 12 through 15 contains only one field. 



A DEMONSTRATION: THE RANDOM PROGRAM 

Lest but by no means least, the System Master diskette contains a program 
called RANDOM thai usee a random-access text file to demon at rule a small 
Inventory control scheme. And by small we nesn small: the program can 

handle at nose 9 parts. This keeps the program simple. The Apple, of 
course, is capable of handling thousands of parts in an inventory. 

First the program rnplco Itself anrl the rnndom-iirri-iol teat file APPl.F. 
PROMS used to keep track of the inventory, then It automatical ly RUNS the 

\iniy,i,iv.i for you- You can list one or all items in the Inventory- You can 
also change items, either one at a time or all at once. Here's how It 
works. Remember to press the RETURN key each tine you complete a 

response - 



I) From the System Master, 
RUN RAKDOH 
and you should see the message 



-T DEMOMSTRHTION WILL NOT E tCUI h UN 
H UKiTE-PRQTECTEO DISKETTE SUCH AS 

DOS SVSTEfl HRSTER <Vt 
FOR VOUR C0NV1 

BEEN MFICC TO COPS' THIS PROGRfW fir* I 
DATA TO ANO 

&o vou wish r< 

If you type N (or "no" in response to the above ci-snafu;, 
you'll find yourself back In Applesoft. 

2) Prefefi Y FOR "yes". You'll see the message 

MOW ROWING OKTf 

Followed by the mespoge 

INSERT mi'- KETT& THE" 

PRESS THE RETi '. rRANSFER 

3) Remove the System Hauler diskette, and piece a 
non-vrite-prottcted diskette in the drive, then press 
the RETURN key. You'll perhcp3 catch a glimpse of 
the message 
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end then the prpgran will begin execution. 
&) Now you should see this: 

RPPLE 
COmiND NUMBER 



LIST 1 

CHflNOE 2 

EXIT 

NUMBER <1 - Ti 1 

Frraa 1 nnd you should Bee this waniige: 

PBRT NUriBER 1-J 

5) Press 0, to get a liBt of all "parts" in this "inventory 
system" and you'll see 

PART* NRME S\2£ In STO 



1 RfiFHLLfcL PRJ 

2 COMMUNICATIONS 256 1230 

rvAit-flO-E ' e 

4 «T HVfilLftBLF> © 

3 "K BOOT 256 432 
«> 

SERIAL PRINTERl 2) 878 

8 RIAL PR' 

9 CENTRONICS 256 1290 

QKTJNUE 

When you're reedy to return to the Hot of options, press 
the RCTBHN key. 

6) try out the various prograa options. Choice I allows you 
to list parts by part nuebcr. one lit n tine, as well as 
all at once. 

Choice 2 allows you to change any or all part naoe-d and 
descriptions. For example, Suppose part 1 should be 
naaed COSMIC GLUE, size 56, with 1234 in stock. Here' J 
how to revise the entry for part 3: 

select option 2, CHANGE 

select part number 3 

the old part name Is displayed, with the cursor at Its 
start, to allow you to enter the new nane; when you 
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press the RETURN key the rursor trill move to the right 
and perform similarly for part size and quantity 
M u'jl- the currently existing name or size or quantity, 
jtisc press the RETURN key by Itself. 

Chnice i will utnp the program. 



WRITE-ING AND READ-ING RANDOM-ACCESS TEXT FILES 

When used with random-access files, the CLOSE command works exuctly as it 

does with sequential files [see "OPENing and GLOSEing Sequential Files" In 
Chapter 6). However, the syntax lor OPEH has in additional parameter, tin- 
t paraaecer, which 1» required . 

OPES t ,LJ |,Ss] I, HI [»VV] 

The "L" stands for "Lco^th-of-rccord"; the number j Indicates how many 

liyt ra (characters and digits) are to hi- allotted to add) record In the 
randoB-acce33 file you're creating (or, If you're retrieving a file, the 
nunber that were allotted when the file wau created). If the L. option Is 
omitted, J Is assigned the default value of 1. The number J oust be In 
the range i through 3276 7. 
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When you OPEN a file prior to HEADing . if you specify a different Length 
parameter, than you specified when you OPENed prior to WRlTEinn the 
file, DOS will blindly use the new Length parameter to calculate record 
positions within the file. You will hove to keep detailed written 
documentation on the structure and contents of your flic? (some 

programmers keep such lnf rirmatlnn In record ft of the file). It's helpful 
to always include the Length parameter in each file's nam, with Such 
names as 

RAN!lK1IKS,|.?Vl 
STOCKLISTS-1,100 

DIftECTORIES(L50) 

There is no way to find the length of o record in a random-access file: 

you must make this information part of your documentation. 



® 



Records should never be longer than the number of bytes specified hy the L 
parameter: records nay be partially over-written or combined with 
confusing results - 

WHITE and KKAIl each have an K parameter, CO be used when creating or 
retrieving particular records in random-access files. 

WRITE f [,Rr] 
READ f [,Kr] 

Examples* WR1TK UiGIBLY, B3, 
READ FAST, R13 
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The Rr (Record) parameter Is used to create (with WRITE) or retrieve 
(with READ) the rth record of the file. The default value of r la 0, 
specifying the flrat record of a file. 
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Using CTRL-C to stop a ftt.AH In Applesoft caused, a string of REENTERS to be 
generated: press the RESET key Instead. 

In boh CMpCCCB, tviph separate record in ii random-access text file may be 
treated as a short sequential file. WRITE end READ can be used with > 
Byte parameter In addition to their R parameter. The Byte parameter 
specifies the beginning byte of the specified record, for the next PRIST 
(after WRITE! or INPUT or GET (after READ). 

WRITE £ t.Rrl t,Bbl 
READ f l.Rrl (»Bb] 

If opacified, the B (Byte) parameter causes WRITElng (or READlng) to 
Iil-kIii at the h-lli liyu- of the fipeciried record. The default Value Of b Is 
0, the first byte nf a record. The B parameter may specify a position in 
the record either before or after the current posltlon-in-the-flle 
|hi Inter. Using tin.- B nnraacter mccc-sel tates a thorough, detailed, 
byte-by-byte knowledge of the contents of each record in the file. 

Once READ or WRITE has moved the positlon-in-thc-flle pointer to a 
particular record, POSITIOH can alao be used to move the pointer ahead 
(only) to further relative-field positions within the record- However. 
POSITION cancels either WRITE or REATI node (ultlumt changing the 
poBitlon-ln-the-file pointer), so another WRITE or READ command (this time 
with no parameter) la necessery to re-Instate that mode. 

Details on how Information is stored on the diskette in general, and In 
random-access files In particular* may be found In Appendix C. 
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MACHINE LANGUAGE FILES 

DOS allows you co store on diskette, and retrieve from diskette, the 
Information in your Apple II's necory. You have already sees the BOS 
commands SAVE, LOAD and RUN: these cocmands deal with the contents of 
Apple's program memory, interpreted as commands in BASIC programs. The 
DOS comsinds discussed in this chapter — BSAVE, HLOAIl and brum — pel 
similar functions, hut they dual with the contents of any portion of 
Apple's memory, in Its uninterpreted, rav binary-and-hexadeclmal form. 

The B before each of the following cocnands stands for ■ Binary file; ■ 
B also precedes the name of binary fllea in the CATALOG. A binary file is 
juat on exact, bit^lor^bit copy of th* information that was stored in a 
specified range of Apple memory locations. Those locations may have 
i-ontnincd a machine- language program, binary data, or a bit-mapped 
"picture" from Apple's high—resolution graphics screen. 



BSAVE 

The BSAVE command creates n file named f and ■tOtBS) nil the rnnlents of a 
segment of memory. The syntax La 
B f .An, LJ I, Sal UDdl [,Vvl 
where as usual the S, I), ami : ■ i (era stand for slot number, drive 
number, end volume number. Note that the A and L parameters "are. not 
optional . 

The A parameter specifies the starting Address CI " either de cimal or 
hexadecltial code) of the memory portion co be stored on diskette. A 
dollar sign < S ) must pr ecede an address expraaaad ill hexadecimal . If 
the A parameter Is less than 9 or greater than 65535, a 
SYNTAX ERHOR 

massage Is displayed. Therefore, equivalent negative address™ may not 
be used with this commend. Within the range through 65535, no error 
message is generated if the A purancter specifies a starting memory 
address that does not correspond to actual. Installed memory chips. In 
practice, it ia not useful to specify on A parameter greater than the 
maximum memory address in your Apple C49151 or SBrTr' ■») a 4BK system). 

The L parameter apseirias the Length, In bytes, of th e mem ory portion CO 
be stored , if the L parameter la leas than or greater than 65535, a 

SYNTAX ERROR 

message is generated • If the L parameter la $ or in the range 32768 
through 65535, a 

RANGE ERROR 

message Is generated- 3276 ! ■• rhr y.i-.-.itest number of bytes th at eon be 
atored In a single field on the diskette If you wi sh to store wo re than 
Z7b? memory locations, use two BSAVEs. Within the range 1 through 32767, 
no error message Is generated it the L par note tar specifias a range of 
memory addresses, not all of which correspond to Actual, Installed memory 
chip. In practice, it is not useful to specify a range of memory 
addrcsiiun extending beyond the maximum memory address in your Apple (411 ">i 
or SBPPP on a 48K system). 
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These examples each create n file named PICTURE containing an Image of the 
second high-resolution graphics area of tin- Apple's memory. They are 
operationally identical, but their storting address and length pa m meter ft 
are given in different forraii. 

BSAVE PICTURE, A$4flv9, LS2U93 
BSAVE PICTURE, A16384, L8192 
BSAVE PICTURE, A163S4, L52M0 
BSAVE PICTUKE, AS4fl09, LB192 



BLOAD 

The b 1-0 All command returns the contents of a Binary file to your Apple Il'i 
memory • BLOAD does not erase a BASIC program In memory, nnlnlil the drttfl 
lg BLOADed into the particular portion of memory cOnlt'i lulnp, yout" program. 

The syntax is 

BLOAD f j.Ae] t.Ss] [,DdJ [,Vu] 

where Ibr S, D, and V parameter 8 are as uoiutl. If the A parameter is 

used, then che Binary file's concents replace a porcion of the existing 

contents of Apple's memory, beginning it address a. If the A parameter 1b 

in i used, the file's contents are returned to the same Apple memory 

locations whoso contents were originally BSAVEd. See BSAVE for o complete 

discussion of the A parameter. 

Assume the binary file PICTURE contains a hlgh-rcsolutlon picture. Either 

of these examples places the picture into the first high-resolution 

graphics area of the Apple's S i oBlo ry 2 

BLOAD PICTURE, A8192 

BLOAI! PICTURE, AS2000 

Either example slso clobbers the RAM version of Applesoft - 

Kote: a Bachlnc-languogo program may no longer be executable 

if it is moved to a memory location different than the 
one from which it wan saved. 



BRUN 

The yyntnx of the BRUN command la the &&me as for BLOAD; 

BRUN f I. An I [.Sm] [,l)d] [ t Vv] 

The Binary file f should be a machine-language program. 

VI ml BRUN does a BLOAD. If the A parameter is Riven, the file's contents 
am placed! Into Apple's memory beginning at location a* If the A 
parameter la not used, the flic's contents arc returned to t h ■- unme Apple 
memory locations whose contents were originally BSAVEd. See BSAVE for a 
complete discussion of the A parameter. 

After BLOADing the file. BRUN does a machine language jump (.'MP! to 
location a. If the file was a machine-language program, this begins 
execution of that program' 
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THE RWTS SUBROUTINE 

Normally, user access to and from the DISK II Is restricted to the use of 
DOS. However, another method of accessing the DISK II Is available to 
machine language- programmers. You may skip this section If you're not 
familiar with machine language. 

The DISK 11 can be accessed directly from bo chine language through the use 
of the RUTS subroutine, which Is pact of the DOS. The "RWTS" Rtands for 
"Read or Write a Track and Rector". In the following explanation, 
any numbers preceeded by S are hexadecimal numbers. 

Every diskette initialized by the DISK II drive is separated Into 35 
tracks, numbered to 34. Thcae tracks nay be thought of as grooves on a 
phonograph record, except that they are not eonnected with each other. 
Basically, the tracks arc arranged in separate concentric circles, with 
the large hale in the center of the diskette forming the common center of 
the circles. Track is on the outer edge of the diskette, while track 3'i 
la nearest the center. The disk drive has a "head" that acts very much 
like the needle on a record player, except that the head on the disk drive 
Is magnetic* This head moves to different tracks on the diskette, where 
ll either reads information off of the diskette, or writes information 
onto the diskette. 

Bach track on the diskette consists of 13 sectors. Sectors are 
pre-defined groupings on each track, that allow the user to work with 
single blocks of 256 bytes, rather than with the entire 332a bytes that 
fit on one track. The sectors within a track are individually numbered, 

ciinii it ivi-ly, i! to 12 around the diskette. As the diskette spins, each 

net-tor will pass underneath the head, at which time the head may write to 
or read from that sector. Each sector consists nf two portions: the 
address field and the data field. The address field contains Information 
concerning which track the head in on, which sector is about to spin paBt 
the head, and the volume number of the diskette The data field contains 
on encrypted form of the actual 256 bytea of data which were stored on 
that sector. 

The "Read or Write a Track and Sector" subroutine (referred to as the EWTS 
subroutine), allows the user to write Information to, or read information 
from, any track end sector on the diskette, via machine language. In 
order to use the RWTS subroutine, the user must first create an KM 
(Input/Output control Block) table, and an accompanying "Device 
Characteristics Table". The IOB tells the RWTS subroutine which slot and 
drive number the disk drive will be in, which volume number to expect on 
the diskette, which track and sector to access , and whether to read from 
or write to the diskette. The Device Characteristics Tabic provides some 
Information to the RWTS subroutine that lo necessary to operate the Apple 
DISK II. 

To use the RWTS subroutine, the user must set up the IOB and the Device 
Characteristics Table somewhere in memory. A "controlling subroutine" 
oust be written and stored in memory. The subroutine must JSR to the 
starting address of the RWTS subroutine (at location 53D9). When the BRS 
subroutine Is jumped to, the A and Y registers must contain the address of 
the starting location of the IOB. The A register most contain the high 
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scoa- 


A9 BC 


U)A 


#sec 


SC02- 


A0 0A 


UiV 


#S0A 


$C0«- 


20 D9 03 


J SB 


Stf3D9 


SC07- 


60 


RT5 




$C08- 


00 


BRK 





ndrfrcag byte, and the Y register the low address byte- The fionnnt of the 
IOB la given In Table 3, ac the end of thia section- Table 4 gives the 
format of the Device Gharaeterifttica Table. 

Here is on example of how to use the RUTS subroutine. The sample IOH, 
Device Characteristics Tables, and a controlling uubroul Ine will all he 

loaded into memory Just after location $C00. 

The following controlling subroutine will load the A and Y registers) with 
the address of the starting location of the 10B, and than Jump to the BWTS 
subroutine ■ 

Load A register vith S0C 
Load V register vith S0A 
Jump to the RUTS subroutine 



The following JOB Is one that you uauld use to access slot 6, drive 1, to 
write 256 bytes of memory starting at location $20(10, onto track IS, 

sector 6 of the AtakftCtaj 

Purpose 

I0B type Indicator, oust be $01 
Slot number tines 16 
Disk drive muaber 

Knpectcd volume number 

Track number 
Sector number 

Low-order byle uf Device Clmr.-irti-r i 'A I n, Table 

High-order byte of Device Characterislico Table 

Low-order byte of data buffer starting address 

High-order byte of data buffer starting address 

Unused 

Unused 

fi WW ill 111 code, $02 • write 

Error Coda 

Actual volume number 
Previous slot number accessed 
Previous drive number accessed 



The following Device Characteristics Table must be included, we'll place 
it at location SC20, just after the IOB. Locations 5C10 and $Clt In the 

IOB above point to the address of the Device Character 1st ica Table's 
starting location- 

- "'" ' "ii Cody Purpose 

$C20 00 Device type code (put a $00 here) 

SC21 01 Number «( phases per track (put a $01 here) 

$C22 BP Time count (put a 5EF here) 

5C23 DS time count (put a $08 here) 



Loral; 1 mi 


Cod 


$C0A 


01 


SC0B 


60 


SC0C 


01 


SC0D 


00 


$C0E 


12 


$C0F 


06 


SC10 


20 


3CU 


0C 


$C12 


00 


$C13 


20 


sen 


00 


SC15 


00 


$C16 


02 


$C17 


00 


$CIB 


00 


$C!9 


60 


$CIA 


01 
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When you hove loaded the IOB at $C0A, the Device Characteristics Table at 

$C20, and the controlling subroutine to load the A and Y registers at 

$C(W, then 

C0OG 

or 

CALL 3072 

will cause the entire routine to execute. 



TABLE 3: FORMAT OF IOB 
Byte! Nsne Purpose 

IBTYPE Telia the RWTS subroutine what type of IOB this 

1st Should be a $01 ■ No other type codas are 
currently defined. 

2 IBSLDT Must contain the number of the slot times 16, 

Ln which the disk drive's controller c*Td is 

Located- For example, if you want to access 

slot #6, the value Soli must be stored In this 
location. 

3 IBDRVN Must contain the number of the disk drive to be 

accessed — either $01 or $02. 

4 IBVOL The volume number of the diskette ts be 

accessed Bust be stored here- Vo3uae $00 will 

natch the volume number assigned to any 
diskette. 

5 IBTRK The number of the track (0 to V.) to be 

;ii-i'i>n.ki.ii i» stored ban- ""■ > «■■ - 'hin the 
range $00 to $22. 

6 IBSECT The number of the sector {0 to 12) to be 

a:cessed la stored here. Must be within the 
range 500 to $0C. 

748 1BDCTP These two bytes muse contain the sddreaa of the 
starting location of the Device Characteristics 
Table (see below). Byte 7 must contain the 
low-order byte of the addreso, and byte 8 must 
contain the high-order bytei 

9410 IHBUFP Bytes 9 and 10 must contain Che address of the 
starting location of the "data buffer"- The 
data buffer Is a 256-byce long section of 
meeory upon which the RWTS subroutine will 

Operate. If you are writing onto the diskette , 
the InfrirmBtlon ln the dota buffer will he 
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written onto this dlnket te. Tf vim at a reading 
from Che diskette, the infornation that cones 
off of the disk will be scored In memory at the 
location of clio data buffer. 256 bytes Is both 
the minimi* And the maximum amount of inform- 
ation that can be read or written by the RWTS 
nub routine. 

11412 Unused 

13 IHCM11 In this byte IB stored the Cumound code that 

tells the RWTS subroutine exactly what to do. 

The values chat can be stored In byca 13 arc: 

Stft) — Null command, floes nothing but start 
the disk, drive and position the head. 

£01 — Head tin- entire 256 bytes stored on the 
diskette at the specified truck and sector, 
and store them In memory at the location of 
the datn buffer. 

$02 — Write the next 25b bytes stared in 

memory at the location of the data buffer on 
to the diskette at the specified track and 
sector. 

Stfi -- Format the diskette. When a diskette la 
f orm.ii teii, F.r I i-t-.yni-lironliing nibbles are 
written on every track und sector on the 
diskette. Because all of the diskette is 
formatted, the values In bytes 5 and 6 are 

Ignored. All of a formatted diskette is 

available for us«; chare is no DOS, or 
anything stored on the diskette until Che 
user puts something there. 

14 IBSTAT This location will contain che code number for 

any error that nay ba encouncered during 
execution. If the RWTS subroutine returns with 
the carry flag, clear, no error linn occurred. 
If It returns with the carry flag oet, this 
byte Indicates what type of error has occurred, 
$10 — Hiokctte Is wri te-protected, and cannot 

be written to. 
520 — Volume Bismol eh isrror. The volume 
number of the diskette found wars different 
than tha volume specified In byte 4, 

$Ad -- Drive i-rriir. Something unusual la 

happening. 

Sa0 — Read orror. The RWTS routine was, after 
48 repeated atli-npts, unnhle to reed either 
the address field or the data Held. If the 
data field For the specified sector has 
n'-ver hod anything written On it, then a 
read error will result, because there la 
n Mli I UK to read. 

15 IBSMOD The volume number of the diskette that 1« 

actually found will be scored in this location. 
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TABU 3: FORMAT OF 10B [ continued 
Byce* Nane Purpose 



16 IOBPSN This byte must contain the slot number tlneo 16 

of the slot that vas accessed most recently. 
For example, If you previously Accessed a disk 
drive In Blot 5* store ttte value $50 here. It 
there is no controller in the specified slot, 
the disk will hang. 

17 10BPDK This byte Bust contain the number of the dink 

drive that vas accessed aost recently — a $01 
or $02. 



Table 4: FORMAT OF DEVICE CHARACTERISTICS TABLE 



Byte* 1 

1 



3S4 



Hame 
DEVTPC 



S'1-IC 



HQBTC 



Purpoia 

Device type code, telling uluii type of device 

Mil'.; is. A S00 should be stored In thin byte 

for use with a DISK II. 



Number of phut* per track, 
stored here- 



A $01 should be 



Motor on cine count complemented, in 100 

aicro-second intervals . A SET should be in 

byte 1, and a $D8 in byte U, for use with j 
DISK It. 
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SELECTING I/O DEVICES: IN#, PR# AND OTHER STUFF 

There are various ways In which Information can be used as Input or output 
for your Apple computer. Very often the keyboard serves as a 9ource of 
input. Usually the Apple uses a TV screen for output, but any accessory 
or peripheral connected to a controller in one of the seven Apple 
accessory slots can be used for input or output using the Hit and PR* 

commands . 

Examples: 

IMC 6 obtains subsequent input from the device controlled Iron 
si nl #6. Motet If slot #6 coTilatnu a disk controller 
card, this command will cause DOS to be booted • If no 

device is In slot lb, the oyulem may "Imiig". Press the 

RESET key co recover. 
INf obtains subsequent Input from the keyboard (not slot It), 

instead of a peripheral device. 
FR0 1 transfers output to the device controlled from slot fl» 

usually the printer. Note! If no device controller 

card is installed In slot #1, the system nay "hang" 
and you'll have to press the RESET key to recover. 
FK# returns output to the TV screen {not to slot Hi. 

The syntax for the commends is 

IN# s 

or 

PR* a 

where b specifics llir- slot In use. What happens depends on a: 

value of s result 

less than SYNTAX ERROR 

t re-establishes usual device (for IN*. Input from 

che keyboard, for PR*, output to the TV screen) 

1 through 7 transfers co device controlled from the specified 

slot (boots DOB if a dink controller card Is in 
chat sloe) 

8 through 16 SYNTAX ERROR in deierrcd-exirut Ion mc.U- j 

the system hangs in Immediate-execution mode 

17 through 65535 RANGE ERROR 

greater than 65535 SYNTAX ERROR 

The command IN' re-establishes input from the keyboard; PR* 
re-i-'itnbllshcn output to the TV screen. 

With DOS In effect, the INC and PR/ cornmnnds «ray bo used in immediate 
execution mode in the usual way (see your BASIC manuals). But when they 
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are issued by linen In a iir.iRrnm, In* and Pft* bual take the forai of DOS 

coamands such as 

10 QS ■ "": REM CfRl,-D 

2<t PRINT D$; "PB* t" 

30 PRINT D$j "IB* 2" 

Whan DOS Is not. In effect, the iiit and PK# commands set the contend of 
the Apple Monitor Input and Output rrglutern in aeleer the desired Input 
and output devices. 

When DOS _is In effect, the contents of the Apple Monitor Input end 
Output registers are sri to Mltct DOS, while the contents of the DOS 
input end Output register* are net to select the desired input and output 
devices. The following paragraphs describe what happens each time s 
character leaves or enters the Apple. 

When the Apple sends an output character, the Apple Honltor Output 
register directs that character to DOS. If the character is to be sent on 

(because it is not part of a DOS command), DOS does a fast two-stage 

Bvitch: 

1. First, DOS replaces the contents of the Apple Monitor 
Input And Output registers with the contents of the DOS 
Input and Output registers. Then It sends the character 
out to the device now selected by the concents of che 
Apple Monitor Input and Output registers. 

2. Next, DOS re-connects Itself by again placing the 
pointers to DOS In the AppU- Tnpul and Output registers. 

Similarly, each time the Apple auks for an Input character, the Apple 
Monitor Input register directs that request to the DOS. Once again, DOS 
does its fast two-stage awitch: 

I- First. DOS replaces the contents of the Apple Monitor 
Input and Output registers with the contents of the DOS 
Input and Output registers. Then it obtains an input 
character from the device now selected by the Apple 
Monitor Input and Output registers* 

2. Next, DOS re-connects Itself by again placing the 

pointers to DOS in the Apple Input nnd Output registers. 

When DOS is In effect, DOS Intercepts all Input characters from the input 
device before they reach Applesoft or Integer BASIC or the Monitor. That 
is why IN* and PR*, when typed on the keyboard as lmaediace-execution 
ceemunds, can be trapped and used by DOS to change the DOS Input and 
Output registera. 

Similarly, DOS intercepts all output characters from che Apple before they 
rmrli [In* iiuipuE device (but alter they have affected the Apple Monitor 
Input and Output registers) • That is why ISI and PR#, if Issued froa 
within n program hut not In PRJNTed DOS commands, can dlaconnecc DOS by 
changing the Apple Monitor Input ond Output registers before the cowmandfl 

ever gee to DOS. Because the entire contents of the Apple Monitor Input 
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and Output registers ere replaced each tine DOS attempts to send or 
receive a character, DOS will usually re-connect itself If. It was act 
disconnected at both Input and Output registers simultaneously. 



(ffil 







ii you Execute * PR* command from within ■ program, with a program lint 

such aa 

50 PR* I 

then DOS will be partially disconnected and unable to Intercept subsequent ,__ 

output. DOS la still connected tor input ■ end the next attempt to obtain 

any input character will cause DOS to re-connect itself for both input and 

output . 

The same situation occurs with the use of IH# inside programs when DOS is 

in effect. A program line sucli as 

60 IN* 1 

will disconnect DOS for subsequent input. DOS is Btllt connected for 

output, and the next attempt to send out a character (even a return or a 

proept character) will cause DOS to re-connect itself for both input and 

output. To avoid such conflicts and allow DOS to manage the Input and 

Output registers, issue PR* and IS# conmanda in immediate-execution Bode. 

or aa DOS commands In program lines such aa those mentioned earlier: 

10 DS - ""; RET! CTRL-D 

Z1J PRINT D5; "PR# I" 

30 PRINT D$i "Wt 2" — .. 

The CTRL-D character talla DOS that th* following output characters arc ci 
DOS command. 



3 
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TABLE 1: APPLE MONITOR INWT AHD OUTFBT REGISTERS 



Monitor Input Register ! Locations 5li-5J <$38-$39) 



When Register 

contents To the 

ate iir by value 

KKSET -741 

CTHL-K (Hote 1} <$FniH) 

IN#B INOCB 2] 



s CT8L-K [Note I] 
IN*s fNoca 2] 

i where s>(J ] 



49152 + b*256 



Then uubsequcnt Input 

coats from 

Monitor Input Knul j m- 
from Apple keyboard 



Slot fs 

If slot is contains disk 
controller! then bnnt DOS 



DOS boot 



-8626 + lop of hi. DOS 

C-S21B2 + Stop of Hem.) 



Monitor Output Renlgter : Locations 54-55 ($36-537) 



When Register 



rnnfenl n 

ore set bv 

RESET 

(.TKt.-P [JJtite 1] 

PR*0 [Note 21 


To the 
value 

-528 
(SPPF0) 


b CTRL-P [Hote 1| 
PR#8 INote 21 
[ where s>0 ] 


49152 + 1*256 

<SCs0«l) 



Then subftequent output 

KQea to 

Monitor Output Routine 
to TV screen 



Sloe ta 

If Blot Fb contains dick 
controller, then boot DOS 



DOS boot -8577 + Top of ncm. nns 
(-$2181 + Slop of nan.) 



Hot* I. The coamsnds e CTRL-K end e CTRL-? ere Monitor commands- 
type CTRL-K (wtilth. does not appear on the TV screen) , type K while 
holding down the CTRL key. 



To 



Note 2- When DOS Is In effect, this command will affect the contents of 
the Apple Monitor register only if the connand is Issued as an Instruction 
in m stored program and: not in a PRINT CTRL-D instruction. 

Note 3. lit Addition to this commands mentioned in Table I, directly 
FOKEing appropriate values into the Apple Monitor register locations can 
»l»o be used to select Input and output devices, or to rC'Connoct a 
disconnected DOS. 
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TABLE 2: DOS INPUT AND OUTPUT REGISTERS 



DOS Input Register 



When Register 






contents 


To the 


Then subsequent Input 


are sac by 


value 
-741 


cooes Ecob 


DOS boot 


Monitor Input Routine 


RESET 3D0C 


(SFDIB) 


from Apple keyboard 


TH#jt [Nate 4] 






PRINT D5;"INI0" 






[Nate 5) 






IN#S [Note 4J 


49152 + s*256 


Slot 5s 


PRINT D$;"IH*s" 


(SCitf) 


IE slot la contains s 


[Note 5] 




disk controller, then 


[ where s>Q ] 




reboot DOS 



DOS Output fteftlater 



When Register 




contents 


To the 


are set by 


value 


DOS boot 


-5Z8 


RESET 31)01: 


CSFBF0) 


PKffJ IKotc 4] 




PRIST D$;"PR#<J" 




INotc 5] 





PR's [Note 43 

PRINT D$j"PR#s" 

IHole 5] 

( where s>0 1 



49152 + »*256 



Then subsequent uiitput 
Roes to 

Monitor Output Routine 

to ch« TV screen 



Slot Iv 

tt sloe #s contains a 
■It nil controller, then 
reboot IMS 



a 
a 
a 
a 
a 
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Note A. When DOS is In effect, this roraswrid will nut affect the 

< oiitents of the DOS Input and Output registers If the command ia IbbuitI u^ 

an instruction In a stared program and not in a PRINT CTRL-D Instruction- 

If a progr«n line such as 

120 VKH 

Is executed, the content! of the Apple Monitor Output register will be 

changed, leaving DOS partially disconnected until the nest Input. 

Note 5, Itl thil command, it is assumed that the string-variable named DS 
has been assigned the churnctor control-D, or CTRL-D. This character, 
uhirh ilws not Appear on the screen, is produced by typing D while 
holding down the CTBL key. 

Not* 6. No Batter what input or output device is selected by the DOS 
Input and Output registers, Input can also be received froB, the disk and 

output can be sent to the disk- 

Note ?• In .-ailillt Ion to the coananus. in Table tt, directly POKElng Che 
appropriate values into the DOS Input and Output register locations can 
also be used to select input and output devices- However, the specific 
■ternary Locations of the DOS Input and Output registers change with 
different system mcerory sizes and wLth different versions of DOS. For 
this reason, a special procedure exists (or changing the contents of the 
DOS Input and Output register locations. It Is s two step procedure! 

a) Change the Apple Monitor Input and Output register 
locations to the values you wish the DOS Input and 
Output registers to contain. (This may be done by 
directly POKElng the Apple Monitor register locations 
or by executing IN* and PRf non-DOS instructions in a 
stored program. ) 

b) CALL IMZ (fron the Monitor, you would type $3EAG). 

After this CALL, DOS will be re-connected via the Apple 
Monitor registers, and the previous contents of the Apple 

Monitor Input and Output registers will appear in the DOS 

Input and Output register locations. This CALL can alio 
he used to ri'-rmmi'i't DOS Any time your program needs 
to disconnect DOS for awhile. See the prog ran on page 
i r 'l for an example using this technique- 
Note 8. The Monitor commands s CTKL-K or s CTRL-P , when typed on the 
keyboard, are not recognized by DOS: they affect the Apple Monitor Input 
or Output registers directly. 
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INTEGER BASIC CHAM 

Certain applications are most easily implemented by using a series of two 
or more programs which are I.OADed and RUN sequentially. Tn such 
circumstances, Che second program often needs to use the values of 
variables and arrays developed by the t'lrut program. The usual HUH 
command craws the first program's variables and arrays when It loads 
the second program. In Integer BASIC (but not Applesoft) the DOS 
command CHAIN allows you to load and run a second program ul [limit 
erasing the first program's variables and arrays. 

Suppose you've been using an Integer BASIC program called PABT ONE. The 

command 

CHAIN PAKT TWO 

will load and run the Integer BASIC program called PART TWO without 

clearing the values of nny variables used in the program PART ONE. The 

CI1AIK command may be issued in immediate-execution mode as shown above, or 

from within the last lines of the PART ONE program as 8 DOS command: 

20014 DS*" H : REM CTRL-D 

20020 PRINT D$j "CHAIN PART TWO" 

Tin.- syntax for the command is familiar: 
CHAIN f l.Ss] f,Bd] [,VvJ 



APPLESOFT CHAIN 

The CHAIN command works only with Integer BASIC, but If you do not need 
to pass variables, it is easy to link Applesoft programs to load and run 
tn sequence. In the first program, just Include a last line such as 

20000 PRINT CHR$(4); "BUN PART TWO" 

When this line Is executed, It will start up the second program (where the 
second program is nsmed PART TWO). In the process, the first program and 
all itd variables are erased. 



A different procedure must be used In order to load and rim a series of 
Applesoft programs without craning earlier values of variables and 
arrays. To chain in Applesoft, you will need to use the maehine-lanjuage 
program called CHAIN that is on the COS version 3-2 System Master 

diskette. 

To i-lmin from a program called PART ONE to a program called PART TUX), you 
Mien hove the CHAIN program on the same diskette with the program PAKT TWO 
(see next page for instructions). Then, simply insert these two lines as 
the last two lincB to be executed in the PART ONK program: 
20000 PRIHT CHRS(A); "BLOAD CHAIN. A520" 
200 10 CALL 520"PAET TWO" 

The two lines may use any line numbers, but they should come one after the 
other in the program, as Indicated. The first line loads the Applesoft 
chaining ability Into the computer. The. second line actually does the 
chaining {but see next page, for warning)- 



□ 

z 
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® 



There must be no apace In the third Una between the CALL address 32» and 
the following quotation mark. The 'CALL address must not be Riven ln 
hexadecimal. 



If you have Applesoft on the flrnwnra ROM card, you can copy the CHAIN 

progrsa onto another diskette as follows. First place the CHAIH program 

Into Apple's memory, ulth the command 

BLOAD CHAIN, A2056 

Then save It on the desired diskette, with the command 

BSAVE CHAIN, A2056, 1.41ft 

if you ire using RAH Applesoft (on diskette), you can copy the CHAIN 

program onto another diskette aa follows. First place the CHAIN program 

Into Apple's memory, with the command 

BLOAD CHAIN, A12296 

Then save It on the desired diskette, with the command 

BSAVE CHAIN, A12296, L456 

® 

Note that neither Address parameter for copying CHAIN Is the same as the 
Address paraneter for actually using CHAIN- 
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APPENDIX/ 

FILE TYPES USED 

WITH DOS COMMANDS 



110 By DOS Conraand 

111 By File Type 



Unices otherwise Indicated, DOS caanands nay be used either In 
iMnediate-execution mode or In deferred-execution mode (ulthln a program) < 
However, soma text file commands (e.g. READ and WRITE) must he used In 
deferred-execution mode. 

Most DOS innmands refer to a mice 4 file- A file may be a rext (data) 
(lie, or a program In Integer BASIC. APPLESOFT or Machine Language. The 
tablet below Indicate which file types nuty be need by each command. The 
first cable lints the conmunda alphabetically j the second table groups 
then by associated flit type. The commands CATALOG. FP, INT, KAXFILES, 

HON, RQMON, PR# ,-iml IK* ate nnl Included because they do not explicitly 

refer to named files. 



FILE TYPE USE, LISTED BY DOS COMMAND 



DOS 


Integer 


Applesoft 


Sequential 


Random 


Machine 


Command 


BASIC 


BASIC 


Access 


Access 


Language 


'.'■.1'!, 


Progruo 


Program 


I'.-xl 


. i .-. ! 


Binary 


Files: 


File 


File 


File 


tjU- 


.- ■ 1 -.-■ 


APPEND 






K 






BLOAD 










X 


BR UN 










X 


BSAVE 










X 


CHAIN 


X 










CLOSE 






X 


X 




DELETE 


X 


K 


X 


X 


X 


EXEC 






X 






IN IT 


X 


X 








LOAD 


X 


X 








LOCK 


X 


X 


X 


X 


X 


OPEN 






X 


X 




POSITION 






X 






READ 






X 


X 




■<;•;>.-■ 


X 


X 


X 


X 


X 


RUN 


X 


X 








SAVE 


X 


X 








UNLOCK 


X 


X 


X 


* 


X 


VERlFf 


X 


X 


X 


x 


x 


WBITK 






X 


X 




Note J ii wr 


l hl'Kf r 


mnmaiitfla only 


in deferred 


execution mode: 



APPESD. OPEN. POSITION. HEAD, WRITE 
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FILE TYPE USE, LISTED BY FILE TYPE 

Inir-fti'-r HASH flips only 

CHAIN 



I m: ;•>■..-! :1AM <■ i-v AiT-l .CSOFT Ell« 

IMIT 

LOAD 

SAVE 

HUN 



Si'i^iii'tit IjiI Tg»t flips only 

APPEND 

EXEC 

POSITION 



Either Sequential Text Ftlea or Randn«i-AccenB Text Flleg 

OPEN 

CLOSE 

READ 

WHITE 



Machine Lanaujat tilt* only 

atoAB 

BKUN 
USAVK 



All Typi". <■! Ktli-'ii 

DELETE 

LOCK 

UNLOCK 

RENAME 

VERIFY 



Note: these commands must bt used in deferred-execution model 
APPEND, OPEN, POSITION, READ, WRITE 
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When DOS detects an error connected with disk usage, It normally displays 
a nessage describing the error and stops any prograa that is running. 
These messages are; In addition to the usual messages generated by 
Applesoft or Integer BASIC. DOS messages can be distinguished from those 
of Applesoft or Integer BASIC as follows: 

An Applesoft message, auch as 

7 SYNTAX ERROR 

Is preceded by a question nark. 

An Integer BASIC message, such ns 

*** SYNTAX KRR 

Is preceded by three .ist r-ri ska . 

A DOS message, such as 

SYNTAX ERROR 

Is preceded hy no character at all. 

A IMS message appears exactly the same, whether you are in Applesoft, 
Integer BASIC or the Monitor at the tice the message is generated* 



$ 



If a DOS message occurs when you are using the Monitor, the system la 
react to the type of BASIC from which you entered the Monitor. 

By using Applesoft's ONERR COTO command (ace the Applesoft manual), you 
can create Applesoft error-handling routines that deal with DOS messages 
ulili-h wiiu Id iinfmiil I y interrupt your program. When a DOS error occurs 
following an ONERR GOTO command in an Applesoft program, a code number for 
i lir type DJ error is Btored in decimal memory location 222. This la the 
Same memory location in which Applesoft stores the code tor an Applesoft 
prror message. The command 
Y - PEEK(Z22i 

sets the value of Y to the Applesoft ONKRR GOTO code corresponding to the 
error that caused an Appleaoft ONERR GOTO jump lo occur- 

DOS messaged and their corresponding Applesoft ONERR COTO code-J an- shown 
below, with the moat common cause of each message- Each of the messages 
io then discussed in greater detail, with a more comprehensive Hat of 
causes and cures. 



ONERR GOTO CODES 



code 



DOS massage 



Hn'.u rnmnini cause 



UVNCUAGF. KOT AVAILABLE Appleaoft not on diskette 



RANGE ERROR 
WRITE PROTECTED 
END OF DATA 
FILE KOT FOUttB 
VOLUME MISMATCH 



ComouaniL parameter too large 
Wrlte-protect tub on diskette 
READing beyond end of text file 
File misspelled, or nnt on diskette 
Wrong Volume parameter 
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DNERR GOTO 




code 


DOS message 


a 


I/O ERROR 


9 


DISK. FULL 


19 


FILE LOCKED 


11 


SYNTAX ERROR 


\2 


NO BUFFERS AVAILABLE 


t3 


KILE TYPE MISMATCH 


14 


pkiigkAH too LARGE 


II 


NOT DIRECT COMMAND 



Host cninpriTi rauflg 

Doar open, or diskette not IMTed 

Too many files on diskette 

Attempt to over-write a LOCKed film 

Bad file name, parameter, or commit 

Tob many text files open 
Diskette file doesn't Batch command 
Insufficient Apple memory available 
Comnand must be in a program 



DISCUSSION 

LANGUAGE NOT AVAILABLE (OKERR GOTO code - I) 

Occurs If WIS I'nnnot find a programming language, either Integer BASIC or 
Applesoft, that is required to esei-ute .1 BOS f 0— lllll- The commands FP, 

INT, LOAD and RUN nay all initiate a Language search. It Integer BASIC is 
requested, DOS looks for that language in ROM, If Applesoft is requested. 
DOS firm iniiks. (or i in- language- In ROM, using Applesoft from an Applesoft 
firmware ROM card (if available) regardieiis of the card's AUltch 
position. If Applesoft is not found in ROM, DOS looks on the diskette in 
the "default" disk drive — the drive indicated by the default or moat 
recant v.-iiues of the s and d parameters. DOS will not look on any other 

disk drive. 

This MSWATI' nuiially arises after a WIS request for diskette Applesoft, If 
the diskette in the default drive does not contain the program APPLESOFT, 
Replace the diskette with one that contains the program APPLESOFT; or use 
the P parameter with any DOS coomand, to select the another drive- A 
command such as this will do nicely: 

fp, r>: 

If you think DOS should have found Integer BASIC in ROM, but it didn't. 
try the following: 

I. Turn nl I your Apple nnd remove the cover. 

1. Locate the row nf four large W1M chfpn (black, rcctnugular 

objects) In the aiddle of the main printed-circult board- These 
chips are Labeled "ROM FB", "ROM F0", "ROM E8" and "ROM tt" . 

3. Press down firmly on these chips. 

4. Replace the cover, turn on the Apple and try INT again. 

If you think D05 ahould have found Applesoft on your firmware ROM card, 
but it didn't, cry the following: 

I- Turn off your Apple and reaove the cover. 
Z> Unplug the Applesoft firmware ROM card. Locate the row of 
five large RON chips (black, rectangular objects) across the 
card. These chips nro labeled 1, 2, 3, 4* and 5 above 
the elilps, and D0. D8, it, E8 and 79 below the chlpu- 
3- Press these chips flraly into their sockets ■ 
it. Plug the Applesoft cord bock into slot #d, the leftmost slot. 

5. Replace the cover, turn on the Apple and try FP again- 
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KANCE ERROR {QNERR GOTO code - 2 or 3) 

Occurs when the value of a DOS coamand parameter or a DOS command quantity 
is too large or too small. Refer to the mnual to see which BOS conmancs 
are used with which parameters. 

Bang* 





Parameter 




Le 


tter 


Minimum 


Maximura 


All Files: 


Slot 






S 




1 




7 




Drive 

Vol um« 






D 

V 




I 
9 


ft 


2 
254 


Sequent Lai 
Text Files: 


ftytf 

Relative Field 
Absolute Field 


(EXEC) 


a 

R 
R 




9 

9 

: 




32767 
921*7 
32767 


Random— Access 

Text Files: 


Record Length 

Record Kunber 






L 

B 




l 
9 




32763 
32767 


Binary Flics: 


Starting Address 
Number of Bytes 




A 
L 




9 
l 




6S53i 
32 767 




!XlS Climraind 




Qua 


nl llv 


HI 


CI 1 llllti:: 


Mux I rami 




PE# a 
INI a 






B 

a 




9 

1 




16 ** 
16 ** 




MAXFll.ES ti 






n 




1 




16 


* HI nl inn a vo 


lime number INIT 


will 


act 


ll ;1 1 : , 


.1 f. fi 1 


BE 


to a 


diskette 



** Maximum slot number built Into the Apple II is '. In deferred- 
execution mode only, the SYNTAX ERROR message Is given for s Valuta 
from 8 through 16. 

Note: The uie of values outside the above ranges does not always cause the 
RANCH ERROR message. Any DOS command parameter or command quantity that 
It iris than 9 or greater than 65533 will cause the SYNTAX ERROR meseage, 
not the RANGE ERROR message- 



WRITE PROTECTED (ONERR GOTO code - 4) 

Occurs when DOS at Leapt o in aCOK information on a diskette, but the diak 
drive does not detect a "vf Ice-erotecc" notch or cutout on the left wide 
of the diskette**: outer case. The following are the moat likely causes: 

1. There la an adhesive label placed over the diskette's urlte-proieet 
cutout, to prevent accidentally over-writing or deleting any information 
on the diskette. This label nay be removed, whereupon DOS will SAVE or 
BSAVf, or WRTTK to the diskette- 

2, There Is no wrlte-protect cutout on the diskette- Thlt> Is true on the 
System Master diskette, for maximum protection. While not recommended, it 
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i ft puntilhli' to rn refill ly cut a notch of exactly the correct size find In 
exactly the correct place. Use mother diskette's write-pro tect notch Cor 
a model. 

3. If you receive this message while RUNnlng the COPY program, and the 
CftuAe 16 not PUlil'T ] or 2, above, yon raoy have inserted the diskette into 
the drive incorrectly (In any other niluullon, BOS gives the I/O ERKOK 

massage to signal Incorrect diskette insertion). Check the dlskaxte'i 
position in the drive, and re-read Chapter l's dtacuRAlon on Inserting 
diskettes. 



END OF DATA (OHERR GOTO code • 5) 

Occurs when you try to retrieve In Fornuil inn from n portion nf n text Illc 
where no information has evsr been stored. Any byte beyond the last field 
in a sequential text file, or beyond the last field of each record in a 
random-access text file, say contain the value 9. Zero is the ASCII code 
for s null character, a "nothing.", and any command that causes the 
retrieval of this character results in the END OF DATA message. Remember 
that only OPEN automatically seta the posit lon-in-the-f lie pointer back to 
the file's beginning. 'Die nu-nyjigi' usually occurs after an INPUT or a GET 
command, and can arise In ucvcrul different ways: 

1. Too many successive INPUTs or INPUT with too many variables. Each 
INPUT or INPUT variable iruun-fi one Additional, adjacent field to be read 
into the Appl >: . 

2. Too many successive GETs. Each GET reads one additional, adjacent byte 
or character into the Apple. 

3. The S (for Byre) parameter was too large. In sequential files, this 
parameter must not specify a byte beyond the last RETURN character in the 
rile. In nndon-access files, the B parameter should not specify a byte 
beyond the laHt RETURN character fn the currently selected record. 
Remember, the first byte in a file or a record Is byte g. 

4. The ft (for Relative-field position) paraontu in a POSITION command was 
too large. In sequential files, this parameter must not specify a field 
beyond the last existing field in the file. In random-access files, 

POSITION'S ft parameter should not specify I field beyond the last existing 
field in ilii' riirri'niHy selected record. 

Remember, the R parameter used with POSITION is not the same as the R 
parameter used with READ. It specific! o Field position In the flic. 
relative to the current file position and forward in the file, only. 
Rfl specifies no change in the current file position, Rl Jumps the Ilia 
position ahead to the first byte following tha field that contains the 
currant position. 

POSITION scans forward through the concents of the file, byte by byte, 
looking for tha Rp-th RETURN character. If it encounter* a 9 byte (the 
null character) before finding the required RETURN character, the END OF 
DATA message la given immediately : It la not necessary actually to INPUT 
or GET the null character. 
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5. The ft (Foe iibiiolute-fiL-ld position) parameter In an EXF.C command was 
coo large. This parameter may specify the first field beyond the last 
exist trig field in a tile, but attempting to specify the second field 
beyond the file's end will cause the END OF DATA message. Renemher, Rfl 
specifies the first field In a file. 

6. The R {for Record) parameter in a READ command specilled a 
randon-access file record in which nothing baa yet been stored. Before 
you can READ from a particular record in a random-access file, you must 
first WRITE some information into that record. 

keuL-mber , READ's R parameter is not the same as the R parameter used by 
POSITIOS or EXEC, read's R parameter specifies an absolute record in a 
6 He; M is the file's f irut record, Hnd so on- 

DOS uses the OPEN command's !. parameter for calculating where the Rr-th 
record begins, so Che OPEN preceding READ must use the some L parameter 
value no the OPEN that preceded WRITE for that file. 



FILE NOT FOUND {ONERR GOTO code - (,) 

Occurs when certain DOS commands specify a file name that is not in Che 
CATALOG for the diskette In the npleeted or default disk drive. Ilnly the 
comnomlft SAVE, BSAVE . IK IT and OPE!) can create a file whose name did no! 
previously cxlot- In addition to these. CLOSE may be used with uny valid 
name. A file name specified by any other DOS command must already exist 
on the diskette. 

This rot-Hnngc eay arise In various ways: 

1. You may have >d.B*peJ L«d the Illc's name, by a typing CXECC »r by 
omitting the comma that separates the file name from a following 
parameter. Check the CATALOG for the exact spelling of the file's name- 

warning: if you have accidentally typed control characters into the name 
Of a file, CATALOG will not display these characters. For help, see 
"File Karnes" in Appendix K. 

2. The file is on another diskette. Check the CATALOG. 

3. The rile has: been accidentally DELETEd, Check the CATALOG, 

4. When you use the INIT command or the UPDATE prog ran on a diskette, you 
specify a file name which DOS thereafter attempts co RUN each cine you 
bBOt thfl system with that diskette in di«fc drive I- Unless you write a 
BASIC program, and ssve it using the name given to INIT or UPDATE ■ the 
FILE SOT FOUND message will be given each time the system is booted with 
that diskette In drive 1. If you can't remember the name of this 
"greeting program". Just UPDATE the diskette again. 



VOLUME HISHATCH (ONERR GOTO code • 7) 

Occurs when the Volume (V) paraneter used in a DOS command is not the same 
an the voLnae number assigned tn the diafcecte Ln the default or selected 



118 



disk, drive, when that diskette was INITialized. The volume number of a 
diskette Is shown ■( the head of each CATALOO display. Ililcse a DOS 
comnnnd specifics a particular volume, the diskette's volume number Is 
iRnored , and no message la Riven. If a DOS command specifies volume 0, 
the diskette's volume number is still Ignored . II" no volume number is 
glv«n With INIT, or If volume number ft Is given, the diskette will be 
Initialised with the default volume number 254- 



l/O ERROR (ONERR GOTO code - 8) 

Occurs niter an unsuccessful attempt to store dot* on a diskette or to 
retrieve dato iron a diskette (DOS tries 96 tines, then gives up). This 
message can occur In the following ways: 

I. The selected or default drive's door is open. Close the door to the 

disk drive* 

Z. Ho diskette in the selected or default disk drive. Put a diskette Into 
the drive and close the drive door. 

3. Diskette in the selected or default disk drive has not been 
INITialized. WIT the il !.•.).. -i I , r.mri UPDATE il to a muster diskette, If 
you wish). 

*■ Diskette is Insured Incorrectly. Check the diskette, and re-read the 
section in Chapter I On Inserting diskettes. 

■"• During execution of a VERIFY command, DOS found the specified file was 
not stored correctly on the diskette, if the file's Information la still 
In netnory, try storing it again (perhaps »n a different diskette). 

6. The pos command's D (Drive) parameter has specified a disk drive that 
does not exist in this system. The default drive Is now the non-existent 
drive. Just specify the correct D parameter with the next DOS command to 
reset the defaul i . 

7- The DOS command's S (Slot) parameter has specified a slot that does not 
contain a disk controller card in this system. 

You are In trouble. The default slot is now the empty slot your lost DOS 
eniwiuiiui specified. The next DOS command without a slot parameter will go 
to the empty slot and return the sane message aa before. Worse yet, DOS 
thinks the disk drive which does not exist in that slot Is still 
runninft . The next DOS command specifying the correct Blot will send 
tha system Into permanent limbo, waiting for the non-existent drive to 
stop running before It turna on the newly-selocced drive. You must either 
rc-hoot the system (losing any program In memory, of course) or else: 

a) Type CATALOG. Ss (where s ■ correct slot) 

b) Press the RESET key (when the (system hiinfO 

p) Type 3D0G (system Is now okay aRaln) 
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DISK FULL (QNERR GOTO code - 91 

Occurs when DOS Ateeoprs to store InformArjnn on .1 diskette, and finds 
that no nore storage apace la available on that diskette. A maxlmun of 
403 sectors can been filled with user-scored information, « displayed in 
the CATALOG (if an individual file exceed! 255 sectors, the CATALOG 
display of its length starts over again at 000)- If you receive the DISK 
FULL cessage, rest assured chat all files are CLOSEd, and that wis saved 
for you nil Ic could (leaving you with some portion of your file not on 
the diskette}- If you receive this message while snvlng n file called 
SfUPP, the first thing you should do is to 
DELETE STUFF 

and then save your program on another diskette that has more room left. 

® 

If you receive the DISK FULL message and then immediately try to SAVK, 
DSAVE or WRITE any file on the diskette before DELETEitig any files, then 
(ore you ready?) the sector length of the eighth entry shown in the 

CATAI/JG will be set to 9. Don't desptalri deupiti- the odd appearance of 
1 In- r I k'i! l> untry'n CATALOG display, the file Itself la in fine shape. 
tithiT urid events may iit-rnr as well. To Avoid such situations, if you get 
a DISK FULL message. DELETE some files before trying to save other (lies. 



FILE LOCKED (ONERR GOTO code - 10} 

Occurs when you try to SAVE, BSAVE, WRITE or DELETE using a file name that 
has been LOCKed on the diskette that la in the selected or default drive- 
Check the CATALOG display: the names of LOCKed files are preceded by an 
asterisk < * ) in the CATALOG display. A file Is LOCKed to prevent 
accidental over-writing. Use another diskette or UNLOCK the denln-d file. 



SYNTAX ERROR (ONERR GOTO code - II) 

Occurs when DOS encounters a syntax error in a DOS command- Check cha 
manual for the exact syntax required lor the command In question. The 
problem asy be a non— val Id file name (see Appendix F), an incorrect 
parameter symbol, a missing poxoneCeri a mining or incorrect separator 
(usually a comma). This message will ml*d arise if a parameter value or 
eommntid quantity is a negative number or is greater than 65535, or, in the 
case of the IN* mod PR* commands used in deferred-execution mode If the 
specified slot Is trom 6 through 16. 

Rarely, every DOS command causes the Applesoft or Integer hash: Syntax 
Error message. This usually means that DOS has not been boated or has 
become "disconnected" from Input and output. Try pressing the RESET key, 
Chen typing 3D0C- to reconnect DOSj n r, re-boot the disk. 
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NO BUFFERS AVAILABLE (iMKKk (JOTO code - 12) 

Occurs when a DOS command requires another file buffer for input or 

output, and all the available file buffers ore already in uue. On boating 

the system, DOS reserve* enough space in the Apple's memory for three 
lnpuc-and-output file buffers. A subsequent HAXFILES command can increase 
or decrease the number of available file buffers, and a CLOSE romnumd can 
release file buffers currently in use for text files. 

Kany DOS commands use one file butter fur Input cir output during their 
execution, and then relinquish that buffer vhen execution of the command 
haa ceoued- 

When a text file is OPENed, a f 11* buffer is assigned to that file for 
input and output' This buffer remains in use, generally, until its file 
is CLOSEd either specifically by flic name or by the Mit l wn CLOSE that 
de-allocates all the text-file buffers. A text (11* to not automatically 
CLOSEd by a program's coming, to an end. To conserve buffer space, CLOSE 
I lies os noon oa you arc through unlng them. Roaember that the next OPEN 
vill rc-set the poaltlon-in-the-filc pointer to the file's beginning. 
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The HAXFILES command can be used to increase buffer apace before writing 
the program or loading the progran into memory. Increasing HAXK1LKS moves 
HIMEM down, and this can eraae stored Integer BASIC program lines or 
Applesoft (.(rings. Changing HAXFll.F.fl In the middle oT a program con be 
especially dangerous- 



FILE TVPK MISMATCH (OKERR GOTO code - 13) 

Occurs when a DOS comaand attempts to use a file name that la already 
assigned to a file whose file type is Inappropriate to the present 
commend- If you are sure the command is correct, use a file name that Is 
not now on the diskette, use a different diskette, RENAME the existing 
file or DELETE the existing rile. 

Thle message .-urines front several different Incorrect combinations of DOS 
cnBniunda with existing file types. Here sre the correct combinations: 

load r , Kirn i , 8AVI I f must be an Applesoft or Integer 

HASH: program file. 

CHAIS f t must be an Integer BASIC program file. 

OPEN f, READ f, WRITE f, ( must be a text file. 
APPEND f, POSITIOH f, EXEC f 

BLOAD f, BROS £, BSAVE I I oust be a binary program or data tile. 

The greeting program's file name, specified with ISIT or UPDATE, 
muat refer to m\ Applesoft or Integer RAS1C program file. 



125 



PROGRAM TOO LARGE (QNERR GOTO code ■ 14) 

Occurs when a DOS command attempts to place a diskette file into Apple'H 

memory, and finds the Available nenory insufficient to contain the entire 

file- iou for a previous program) may have set HIMFM too lou for rh? 

current task, or a large HAXFILES may have set HIMEM too low. If you sec 

the number of file buffers to three, using the command 

HAXFILES 3 

then HIMEM will be returned to the booted value given In Appendix D, Table 
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If you are in Integer KASIC, and HIHEH Ih set low (to protect the 
high-resolution screen aeoory, for instance), you may experience trouble 
on shifting to diskette Applesoft- Diskette Applesoft occupies about 
12. SK of nenory, but a ahift to diskette Applesoft (with FP or LOAD or 
RUN) does not rp&et HIMEM to naxlmun. When DOS tries to load the 
Applesoft program fron diskette, the message PROGRAM TOO LARGE will be 
given if HIMEM is below about 13100- The eyficem will be left in Integer 
BASIC again, and you mist set HIHEH higher from Intrgrr BASIC. See 
Appendix D, Table 2 for your system's inns [mum HIHKM with DOS and three 
file buffers. 
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In deciding whether or not a program will fit into the available memory, 
MOS looko only at the number of diskette sectors occupied by the 
program, in general, the program does not completely fill the last sector 
(256 bytes), but DOS ignores this fact. DOS compares only the hlgh-nrdi-r 
byte of LOMEM (Integer BASIC) or HIMEM (Applesoft) with the high-order 
byte of the projected end-of -program location- Thus a progrom which 
should fit into memory, bud nbten would leave less than 236 by tea of free 
memory after loading, may causa the PROGRAM TOO LARGE oeesage. Sonet lines 
this can be corrected by mvlng HIHEM or LOMEM slightly, to change the 
high-order byte, before loading the program* 



NOT DIRECT COMMAND (OKEftft GOTO code ■ 15) 

Occurs when you try to use one of the tent file communis APPEND, OPEN, 
POSITION, BEAD or WHITE rroo immediate-execution mode These DOS romannds 
can he used only from within PRINT statements in program lines - 
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Hi is appendix cells how Information is stored on ■ diskette, and how DOS 
remeEbers where particular information has been scored. 

In the following discussion, a dollar sign ( S ) or the label "Hex" 
preceding, a number Indicates, that the number la expressed In hexadttc lnuil . 



OVERVIEW OF THE STORAGE PROCESS 

In the Disk II tiysteo, information la recorded on a diskette in 35 
concentric zones or bands, called tracks . These tracks ere numbered 
from track 504), the outermost, through track $22, the Innermost. The disk 
drive'* recording and reading head can be moved In and out, to stop and 
hover over each of these 35 different zones of the spinning diskette. 

Furthermore, the length of each track on the diskette Is divided Into 13 
segments, called sectors . These sectors are numbered from $0 through 
$C, and up to 256 ($100) bytes of Information can be stored In each 

sector. Once Che disk drive's recording and reading head Is positioned 
over a Riven track, that track's IS sectors will pass under the head, one 

after the other, each time the diskette trains around. DOS always records 
Information en the diskette in 256-byte chunks, exact!'- filling one sector 
each tine. 

To store information on the diskette, DOS first puts 256 bytes tens 
sectm'~. north) of the inforniat Ion In an area of Apple's memory called a 
(!!■■ buffer . When this file buffer is full, the information is scored 
in one sector on the diskette. Then DOS fills Apple's rile buffer with 
the next 256 bytes of Information and scores that information on the 
diskette. 

In general, DOS will begin storing a program or text file wherever It can 
find an unuaed sector on the diskette. When that SACCor Is filled with 
its 256 bytes "l In) nrmi'i Ion. WIS find" .-mother free sector, perhaps on 
another track, and continues to record information there Tills process 
continues until the entire file has been scored. 

To remember which sectors of which tracks contain the information for a 
particular file, DOS makes up a list of each track and seccor used, as It 
Stores the file. Then HOS stores that list, called a track/sector list , 
in yet another free seccor (or sectors) on the diskette. 

Finolly, the flics'? name, flle-iype, length In sectors, and the diskette 
location of the file's track/sector list are recorded In a apeclal area of 
track $11 called the directory. At this time, too, the diskecca's 

track bit map is updated to correctly show which sectors of each crack 
are currently in use. 



WRITING INTO A SEQUENTIAL TEXT FILE 

Encrlea in a cexc file consist of 1 co 32767 characcera scored ae their 
equivalent ASCII codes nnd ended by a RETURN characcer (elcher ASCII S0D 
or ASCII S8D). Each such entry la called a field . 
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In u sequential text file (no length p am mo tor specified when the file vac 
OPENqd), iields are stored imnediately following each other (uee Chop I i-i 
6). DOS writes the first byte of each new field immediately following, the 
kktiikn rli.ir.ii i :-i Unit ended the previous field (unless otherwise 
instructed by a Byte parameter). Endli lime I lie file la OPENod, DOS 

forgets the current position within the file, and starts WRiTElng again In 
byte 9 (again, unless otherwise instructed by a Byte parameter). 

In order to re-write a particular field or character within fl sequential 
file, WHITE can be used with the B (lor Kyte) prirniaeter to begin writing 
at the specified, absolute byte of the file (the flrat byte In the file 
I* hvti- H, the next in byte I, etc.). The byte specified aay b« before or 
after the current position In the I 



It is very difficult to reaember exactly which character appears In every 
byte of n text file, especially in a sequential text file. For this 
reason, uae of the Byte parameter in sequential text 11 lea In not 
recommended . 



The POSITION command can be UBed with on K (fur Rel.it Ivo-fleld) 
parameter to move a pointer ahead (only) through the file a specified 
number of fields relative to the current position in the file, A 
program portion such aa 



12G PRINT D«. -OPEN N 

iJTE Nfli-if 

B PRINT "RF'PLE COMPUT: 

will attempt to WRITE the characters APPLE COMPUTER into the NAMES file, 
beginning in the first byte of the fourteenth field (the first field is 
Relative-field (I). 
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POSITION can move you to the first byte of any given field Relative to the 
current nonltlon In n sequential text file. If you then re-WRITE that 
field, however, you must cake sure that you re-PRlST c».-ict ly the same 
number of character* that you PRINTed In that field originally. If you 
PR1KT lower characters, you will hove crcoted two new fields; the field 
you Just PRINTed, and the tail-end of the original field you were 
over-writ left. If you PRINT more characters than the original field 
contained, you will have over-written some oi the characters at the start 
of the next field. 



125 



WRITING INTO A RANDOM-ACCESS TEXT FILE 

for ■ nandoo-access text file, a Length parameter, la specified when the 
file Is OPENed. The Length parameter determines the number of bytes In a 
record , which li a field or a collection of fleldi that DOS treats is a 
unit* Each record In a random-access text file la Ilka a separate 
fiequcntl.il Iftiit fllf wliuse maximum total length has been specified by the 
Length parameter. As long as you atay within that maximum Length, you can 
WRITE and re-WBITE all you want, without affecting, any other record In the 
flic. WRITF. Con be used with the R (for Record) end B {for Byte) 
parameters to begin writing into any byte of a specified record. 
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Since ffl^BOS command uill terminate WRTTF.-ing, you cannot use POSITION 
to Jump ahead Into different fielda within the record specified by the 
WRITE command. 



DOS usee, the Length parameter to calculate where to write the first byte 
of each new record ( L bytes beyond the first byte of the previous 
rscord). DOS simply skips over any bytes between the previous record's 
l.iNt i U.irjicter and byte L. The bytes skipped over will eontimie to 
contain whatever values were stored there at some earlier time (Bee the 
next section for details). 
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If you jii tempi io WRITE more characters in a random-acces© record than 
you specified in the Length parameter, all the characters are stored 

Correctly mi 1 1 !■*• rlfski'tte. Hnwt'vi-r, ulu'ii yun begin WRlTElng to the nfejtt 

rscord, DOS calculates the new record's starting position as if the 

previous record, had been ulfliln the specified Length. The new record tttul 
overwrites the last characters of the previous, over-steed record, 
Including the end-marking RETURN character of the previous record's lssc 
field. The result is messy. 



HOW DOS WRITES INTO TEXT FILES: GENERAL PROCEDURE 

When you WRITE a field into a text file, DOS first checks on the diskette 
to ace whaChor or nit >'"ii have already stored information in the sector 
which should contain that Held. If your file has never used that sector 
before. DOS places zeros in all 256 bytes of an Apple flic buffer, and 
then lets you put your information into chat buffer for later storage in 
the correct diskette sector. The contents of the file buffer are scored 
on cha diskette when your information has conpletely filled 256 bytes of 
the buffer, or when the file Is CLOSEd. 

Tlnn. when fan WRITE to n particular sector the first time , unused 

bytes are given the value zero. Ati n;it to READ a byte containing s 

rero (the ASCII code for the null character) will result in the message 
ESI) OF DATA 
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But if DOS findi your file has already stored Information In the sector 
which should contain the field chat you ara now WRITEing, It reads all 256 
bytes from that sector into the Apple's file buffer. After you have 
- lnu^i-d imy of t himi' f I let- hirt Eof byte. 1 . In rrnitnlii your new I nfurmfi I lun -- 
the) WRITE, POSITION (sequential files only) and PRINT COBWSflds take care 
of this for you — [MS then stores the buffer's continue, rlglit back Into 
the the same diskette sector where they originated- The contents of thf- 

file buffer are stored back on the diskette when you attempt to change any 
byte not In the sector that was read into the file buffer, or when the 
file Is CLOSEd. 

Thus, If you WRITE more information Cor a file, and DOS stores that 

interest Ion in a diskette sector already being used by your file, this 
will not re-vrlte any zeros In unused bytes. Any of those sector bytes 
which you did not re-write will continue to contain whatever information 
night have beeo Atored there before your WRITE command. This is I riu> of 
the unused bytes et the end of a sequential text file, end also true of 
the unused bytes in eech fixed-length record of a rerdom-aecess text Eil*. 



CONTENTS OF FILE SECTORS 

Now thjit ynu know the general process of recording n I lie on diskette, we 

can discuss each element in more detail. The actual information stored, 
sector by sector, is different for each type of file. 



FllKHAT OP FH.K SECTORS 
tor different file types 



File 
type 


lii'i'i in 
lat sector 


Byte 
(Hex? 



I 

2 through FF 


Contents of byte 


BASIC 
(both 
types) 


Program length, low byte 
" , high byte 

Token l red prngraa 




Subsequent 
Sectors 


All 
bytes 


Toxeniced program 


Text 


All 

sectors 


All 
bytes 


ASCII representation of 
text; one byc«/charecter 



(588 marks end of file) 
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Sector 


Byte 
(Hex) 




Contents of bvce 


linary 


1st sector 


1 

2 
3 




Starting RAM address, low byte 
" " high byt 

Length of RAH lnage, low bylr 
" high byte 






4 through 


FF 


Binary data 




Subsequent 
sectors 


All 
bytes 




Binary det» 



THE TRACK/SECTOR LIST 

As a file Is Mtored on the diskette, DOS makes a list of Che diskette 
locations used by the file. This crack/sector list Is then stored on the 
diskette tn the anoe way the file itself was stored. The contents of a 
track/sector List ore an follouAE 



Byl a 

« 
I 

2 



First Sector of a 
TRACK/ 5ECTCm LIST 

Contents of byte 



Hot used 

Link: track number where continuation of the 

track/sector list may be found. 

Link: sector number nfeerc rimr inuation of the 

crack/sector lf«t may be Found. 

(If both byte* of Link « 8. no link.) 



1 through B Not used 



Trick nuuber of first file sector 
Sector 



E 



Track number of second file acctor 

Sector ' 



I* 
II 



Track number of third file sector 
sector 



Ft 
FF 



Track nunber of I22nrf file sector 
Sector " 
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If any track/sector pair Is 0/0 this Indicates an urtaftni£gir<l net- cur 
(usually the end of the file, although text 111** amy contain 0/0 
indicators for many aft-yi>i -iinnanlgncd sectors where future bytes or 
records nay be written). 

Subsequent uectors of the track/sector list (If the list extendi beyond 
122 track/sector pairs) are Utonl Lea I !o the first sector described above, 
except that the track/sector pairs refer to subsequent (roup* of 122 file 
nectors. Also, Link bytes 1 and 2 Hill be different for ojutIi suhfic-iiiieiit 
sector. Each Link pair given IMS the diskette locution of the next 
portion of the track/sector lilt. If both bytes of the. Link are 0, this 
indicates the final portion of the crack/fief tor List. 

With a text file, only the Er.-irk/iicclnr piiiru for those sectors actual I v 
containing information appear as non-cero In the track/sector list. DOS 
calculates the correct position for the track/sector pair within the 
list, filling unassigned E rack/sector pairs with teeros. If a conplete 
sector at the beginning of the track/sector list would contsln nothing but 
■*raa a that sector is not stored on the diskette. 

Thiut, if the Length parameter for a randoD-access file Is 123 (two records 
per sector) and you WRITE only to record number 270(1, only two diskette 

sectors are actually used: one for the contents of record number 2700, and 
one for the "twelfth" (and only) sector of the track/sector list. The 
contents of records, number through 2683 may someday occupy 1342 sectors; 

lull liii'II E lirmc records pn vtIcli.ti, clu-v do not (JVC "i 1 "-' d i b) El ti 9V&* ''- 

The track/sector Hat giving the locations of the sectors containing 
records nuaber to 2683 would have occupied eleven additional sectors, 
and the list position of the track/sector pair for record number 2700 is 
calculated a a 1 1 the entire twelve sectors of list were present. 

However, since nothing has actually been written to any of the sectors 
thot may •mmcdoy contain the first 26B4 records, DOS does not keep the 
track/sector Hat for those unused sectors. 



THE DISKETTE DIRECTORY 

On every iNlTlallzed diskette, track Sll lo reserved for Inforantlon 

I'liiiri-riiirip, i In- contents of the diskette. This is where DOS stores the 
directory containing, for each file, the file's name, Its file type, the 
nuaber of sectors occupied by the file (MOD 256), and the diskette 
location of the file's track/sector list. The CATALOG command causes most 
of thin (nformntion to be displayed on the screen. Each sector of a 
diskette directory is formatted as follows: 

One sector of a DISKETTE DIRECTORY 

Byte (Ilex) Contents of byte 

Not used 

1 Link: Track nunber where continuation of the 

directory say be found (normally Sll) 

2 Link: Sector nunber where continuation of the 

directory stay be found 

(If both by ten o f l.luk - 0, no link.) 
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a 



Byte tftoxl Contents of bvt€ 

3 through A Not used 

B through 2D Directory entry for Ella 1 (see below) 

2E throuah 50 Directory eatry for Etta 2 

51 through 73 Directory entry for file 3 

74 through 9o Directory entry for file '< 

97 through H9 Directory entry (or file 5 

BA through DC Directory entry for file 6 _ 

DD through FP Directory entry for file 7 

The file nuobers shown for the seven directory entries nre 

.trlillrary. When n tile Is DELETEd , DOS marks the directory entry (or 
thnt tile (ace following cable). Tne nest time a file is stored, DOS 

replaces tht old marked directory entry vleh the directory entry for the mm 
new file. Thus, while DOS originally fills the directory In the order 
9 noun i tile DELETElons soon render this order meaningless. 

The diskette directory begin* to it.uk gll, BOOCor $C. If more space is 
needed to stori- additional directory entries, inTtuf SC la Linked to 
lector SB. If still &ore apace Is needed, sector SB la Linked to sector 
SA, And sis on, through sector Sit This allows the directory to store 
directory entries for s maximum of 84 different files. 

Each directory entry is written In the following format: 

DIRECTORY ENTRY F03 ONE FILE 

kt-l.ii Lye 
Byte (Hex) Contents of Byte 

Track number of the file's track/sector list 

(Changed to SFF when the file is DELETEd.) 

1 Sector number of the Ella's track/sector list 

2 File typa (see discussion on the next page} 
3 through 20 File nana 

21 Sector count i the number of diskette sector? 

(MOD 256) occupied by the file 

22 End nuirhi nnrnnlty wto 

(but changed to the track location of 
the track/sector list, froo relative 
hyte 0, when the file Is DELETEd) 
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A dlrertnry ratry's rela tive byte specifies each byte within the entry, 
although carh entry starts ac a different actual byt« nuaber within the 
directory sector. To find the Absolute sector byte corresponding to a 
relative byte, add the relative byte to the entry'* first absolute HctPt 
hy 1 1- (mi lisic-d iii the previous table! . 

Because only one byte is used to store a file's sector count, the ran* limim 
directory sector count la 255 ($FF). If a file exceeds ?■>!> sectors, Us 
sector count (as displayed by CATALOG) start* over again at iltIK- This 
does not affect use of the file, but may give an errcincou-, impression of 
haw full the diskette is, 

llu- eight bits of .1 file's type-designating byte, relative byte nuaber 2 
in a flic's directory entry {see previous tnbleK are unsigned values as 

follows: 

BYTE INDICATING THE FILE TYPE 



CATALOG 

Bit Bvabol 



File type dealKTiatud 



I 

A 
I 

T 



File is locked [write protected) it this Ml - I 
Flic is unlocked (not i J) If till" hit - 

Kxpnnslon type fur f in lire use (noranlly tern) 



Binary file if this bit - I 

Applesoft BASIC file If this hll - I 

Integer BASIC file If this bit - 1 

Text file if bits 9 through 6 arc all zero 



The file type Is determined by a 1-bit appearing in one of the bits 
through b. If bitB 9 through 6 are all fl-olts, the file type defaults to 
a Text file. 

The file's type-designnt Ing byte enn thus take nn the lallovlng vnlueel 

VALUES FOR BYTE INDICATING FILE TYPE 



File 
type 


Value of 
File unlocked 


i'Vfl, '- 


yto (Hex) 

File locked 


Text 


1 






80 


Integer 


1 






8] 


Applesoft 


2 






82 


Binary 


& 






U 
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VOLUME TABLE OF CONTBITS 

Sector $0 of crack $11 contains the diskette's Volume table of Contents. 
or VTOC The VTOC stores the Following Information: 



VOLUME TABLE OF CONTENTS (VTOC) 
Track SlU Sector $0 



Ryte 



Value 
(Hex! 



II 



Hcscript ir>n 



Not u-.i-d 

Track number of first directory sector 
Sector 

DOS release number 

Hot used 



7 through 26 
27 

28 through 2F 



3d 
31 
32 
33 



1 through KK Diskette volune number (default: SFE) 
Not used 
7* 



t 



FF 
F8 

m 



Xfixlmnn number of track/sector pairs possible 
in each sector of n trnck/seetor list 

Not used 



hi ■■■!■ Tour bytes are a mask for the 
track bit iwp» (nee next 2 pages): 
each l-hit enables one of the 13 
sectors to be used In every track. 



■ 



a 
□ 



V. 


23 


Kufflbar of tracks 


per 


diskette 




35 


(to 


Number of sectors per track 




36 


M 

01 


Number of bytes per 
ii ii «■ »■ 


seel or, low byte 
high byte 




SB through 3B 
3C through 3F 
40 through 43 







Track bit map 
Track 1 bit map 

Track 2 bit rraip 




(These tracks 

not awoi Inble m 
to the user) 




44 and >'•> 

46 and 4 7 


7 
si 


Track 1 bit map 

rl ii ii II 








[ Continued on 


next page 1 
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Byte 

fftel 

48 and 49 
UK and 4B 



V.ilm- 

(He») 

7 





l lr-- 1 I l|:T log 



Track ^ bit mop 



ii ii i> 



?a and 79 J Track 519 bit nap 

7A and 7B 9 



7C through 7K 



Track SI I bit map (Directory t VTOc) 



80 rind SI 
82 and 83 



Track SlZ bit map 



Cfl and CI 
C2 and C3 



Track $22 bit mop 



Ct through ¥t 



Not used 



TRACK BIT MAP 

Starting In byte $3ft of the VTOC (oe* previous table), 

aubaaquant four-byte groups each contain '•>»• track bl t map 

(or on* of the diskette's i"> l rocks. The nrranRpmont of l-blta 

and 0-bit* within a track's bit map ah awe DOS which nectars of 

that diskette track ore currently In ufie, and which sactors are free. 

bit map for each track uses the following format: 



The 









TRACK BIT MAP 












For 


one 


diskette 


track 










Deslgnattd 










DcwiK.n.-it '-'1 




Sactor 














Sector 


Bvte 


Hit (Hex) 








Byte 


Bit 




(KC*> 


1st 


7 C 
6 h 
5 A 
4 9 

3 a 








2nd 


7 
6 
5 

4 
3 




'. 

3 
2 

1 





2 7 
1 6 

5 








2 ch 


rough 


1' 


Spare 




3r 


d * 4th 


All 




Spare 
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If a bit in the crack bit map contains the value 1, che sec-tor 
corresponding to that bit Is free. If a bit in the map contains the value 
0, the sector corresponding to that bit is currently In use. Bits narked 
"Spare" In the cable above contain the value 9\ these bits are not usedi 

The track bit map for a typical track might appt-ur n«j foljiiws: 



3 



1st byte 

3 1 1 



TYPICAL TRACK BIT HAP 

2nd byte 3rd hyt« 4th byte 

i i i i i o a a M M M B H II M M t 



t . t t 1 t t , t ■ \ t 1 Spare 
CBA9B765 -'■ 3 ^ L tf 



Spare 



Spare 



Sectors designated 



Not used 



I ■* Free sector (assuming the correspond iny» bit of the ifcask, 

VTOC bytes $30 through $33, la also I) 
9 - Sector in Hue 



When h I Ih- i- i-i !.■ stored an tin* diskette (using WRITE, SAVE or BSAVE ) , 
an entire crack ia allocated co the file at once (when possible), and thft 
track's bit map shows che entire track in use. Then, when the 1 1 Li- Is 
CLOSEd, those sectors not actually used are again designated as free, in 
Che bit nap for chac track. 
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Sectors actually used to score a file's information, however, can only 
i . " .,•! free" when that file rvaee is DELETEd. Suppose your diskette 
contains a MW-sector BASIC file naracrl Ktc, for En»t*nc«. if you now 
SAVE, on che same diskette, a 2-scctor I 1 1 ■- wl i li the same name BIG 
(overwriting che old file) a CATALOG of Che diskette will reveal that your 
2-seccor file Bit ia still using up 1W sectors. To free up unnecessary 
sectors used by a BASIC file named Bl(:, use the following sequence of 
commands ! 
LOAD BIG 
OKLETE BIG 
SAVE BIO 

A similar process can be used co release unnecessary sectors used by 
bi tiary f i 1 afl, 

To release unnecessary sectors being used by a tent file, you will have 
to READ each of the file's fleldv Into the Apple. If you store all che 
fields In an array, you can Chen DELETE the original Ell« before KRITEing 
each record beck onto the diskette using the original file name. Another 
way to dn this La to rend each field into the Apple and Immediately WRITE 
Che field back onto the diskette using a file name that is different 
from thft original file name. When you ha«c read nnrl r«— wr Itlen the last 
field, you can DELETE the original file. 



3 

3 
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TRACK AND SECTOR ALLOCATION ORDER 

Kat-Ii diskette i ont.-il tis 3} tracks, throe of which are reserved for DOS and 
one for the Directory, lotvlng 11 tracks for the user. Each track 
contains 13 see tors, to all together 31*13 or 403 sectors are ovaiLable to 

the user. 

Sectors are filled starting with sector 5C and working back to sector S0. 
Tracks ara first filled starting with track SlZ (just Inside the 
ii i rt-i •-( ory/VTOC crack) and proceeding inward to track $22 (the Innermost 
track). When track $22 huu been tilled, tracks ore then filled i.t.iilinft 

with track $1* (Just outside the dlrectory/VTOC track) and working outward 
to track S3 (the outermost track available to the user). 




tory/vroc) 



lir.ketto 



l: 1 

TRACK ALLOCATION ORDER 



) 

SECTOR ALLOCATION ORDER 



^ _ Diskette 
Covor 



KITH I 

Filled 



i ii'. I 
Killed 



First 
Filled 



Last 

Filled 



First: 512 > $22 

Then: 519 > StfJ 



$C 



$0 
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■"-"FORMATION FROM THE DISK 

To retrieve a file from diskette, DOS follows the process used to store 
the file, but In reverse. After ■ command such as 

LOAD FILE 

or 

BLOAD FILE 

for Instance. DOS goes CO the diskette's file directory in track 511, and 

finds the directory entry containing the nana FILE. This entry also 

contains the diskette location (by track and sector) of the desired file's 

track/sector lisc. DOS then goes to this track/sector list, and reads the 

first track /sec cor pair. This pair specifies the d take Lie location of Eh* 

first sector containing Che program named FILE. When DOS has read that 

first sector of program into the Apple, it returns to the track/sector 

list for the location of the program's second sector, and so on. 



READING FROM A SEQUENTIAL FILE 



When READing from a sequent In! cent file, with a program, portion euch as 

5(1 PRINT DS; "BEAD TEXTFILE" 

6tf INPUT AS 

for instance, che general process is like chat described for LOAD in p. a 

program file- However, only the sector containing the text file's next 

t It- lil (all characters from the current position in the file through che 

next RETURN character) is read into the Apple's file buffer in response to 
the INPUT command. Then the actual sector bytes that make up che desired 
field are assigned to the variable A$. This process Is repeated If the 
field extends over more than one diskette sector* Each subsequent INPUT 
command will cause reading of the file eo resume, fron the Apple's file 
buffer If It ol ready contains the propel field, 01 by reading cnothei 
dlskecce sector into the Apple. This continues until the last field Is 
read or soma command CLOSE* the file. 

By using the READ command with the B (for Byte) parameter, you can cuuoe 
the next INPUT to begin reading from che specified absolute byce In the 
file (the file's first byte is (J, the next is I, etc). This byte may be 
before or afcer the current position within che file. To use this 
paraaecer effectively, however, you suae know che concencs of every byce 
In your file. The POSITION command uses the R (for Relaiive-f ield ) 
parameter to move DOS's current—position pointer the specified number of 
fields forward (only) through the tile, relative to the current position 
In the file. Each time you OPES a file, DOS forgets its current position 
In the rile and starts READlng again from the beginning of the file 
(uiiLi'?i:i -iilia-rwlru* Instructed by a Byte parameter). 
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The INPUT command crests a response somewhat differently in Integer BASIC 
and in Applesoft. If certain characters such as the colon or comma appear 
in the response field, further characters in the field may be ignored or 

annlgued hi multiple INPUT variables (if any). For details, see the 
appropriate manual for Integer BASLC or for Applesoft- 
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READING FROM A RANDOM-ACCESS FILE 

The text-reading process In somewhat different when READlng from a 
specified record of a random- access text file (also see WHITING TO A 
RANDOM -AC C liS S PILE In thin appendix). In .1 r,iridoB-eCOO»8 text file, each 
record Is composed ul the some number of bytea, specified In the Length 
parameter when the file was OPENed prior to WHlTElng the HI*. When thin 
Bnw file in uPHNcd 1nl.11- 10 READlng It, an Identical Length parameter la 
given. Io find the beginning, of a particular record (specified by the 
REAI) coamuand'u k parameter), DOS unefl the Length parameter to calculate 
the number of bytes occupied by all the preceding, records- That number Is 
then divided by 256 ($100) to determine how many file sectors DOS must 
skin over to reach the MCtOr containing the deB [red record. Then DOS 

examines the file's track/sector list and finds the diskette location of 
the desired file sector. Finally. DOS reads the correct sector into the 
Apple's file buffer. Then the correct bytes can be read from the file 
buffer. 



$ 



Thia sane retrieval process would be followed even If the text file bed 
originally been stored as a secuential file, or as a random-access file 
using a completely different Length- DOS blindly calculates the sector 

end byte position of the requested record according to whatever Length 
parameter you specify when you OPEK the file prior to HEADing from it, 
rogardlcan of the length parameter {If any) t lint w.is used when WHlTElng 
the file in the first place. 



By using the REAP command with both R (for Record) and B (for Byte) 
parameters, you can cause the next INPVT to begin reading from the 
specified absolute byte in the specified record (each record'* first 

byte Is 0, the next In 1, etc.). Thin byte may be before or after the 
Cat tent position within the record. To use thl;i parameter effectively, 
however, you must know the contents of every byte in the specified record. 

The POSITION comsumd, while primarily Intended for access to sequential 

files, can be used with the R (for Relative-field) parameter to move 
DOS's current-post! Ion pointer the specified number of fivldn forward 
(only) through the current record, relative to the current position In the 
record. READ Is used with the R (for Record, this time) parameter to 
move the current-position pointer to the beginning of the desired record, 

Utflng POSITION cancels READ mode (wftho.it resetting I he ponft Ian-pot nter), 
and another READ (this time, with 30 parameter) re-lnstatcs READ mode. 

Each time you OPEN a file, DOS forgets Its Current position in the file 
nnd Marty RKAning again from the beginning of the file (unlesn otherwise 
instructed by a Byte and/or Record parameter)- 



® 



DOS keeps no Information for you concerning the structure, format, 
record-length, or field-length of your text files. To use your 

random-ncee&fi test files effectively, you nmsi keep detailed written 
Information about the structure of these files, or keep the information at 

the beginning of Lhc tile.. 
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APPENDIX 

MEMORY USAGE 



140 Memory Areas Over-Written When Booting DOS 

141 Memory Areas Used by DOS and Either BASIC 

142 HIMEM Set By Booting DOS 



TABLE 1: APPLE II MEMORY MAPS 

A. MEMORY AREAS OVER-WRITTEN WHEN BOOTING DOS 



Lock Ion on 

any liyGteiiiE 

Highest RAM 
oemory address, 



DOS oc-ves 
tUMEH here 
( Not* 2 I 

16383 C$3m> 



7424 (S10BB> 

6912 mm) 

2559 <$9FF) 

anifl mm 

1*23 <$3FF) 

758 {$3«fl) 

Lowest KAH 
Mifnfiry iuUlri'i-is 





8960 KL-loeared DOS, 
($2300) on completion 
oytes of boot 

f 






7 bytes not used 






1 
1792 Thro* file 
($70(9) buffers of 
bytes 595 ($253) bytes 

for input fi output 












DOS, where firs! booted 

from a Master diskette 
[ Nntu- 1 ] 






DOS Relocation Code 

E Koto 1 ] 












"Nibble" bluffers 

uaad during boot 












First Stage boot 
starts here 




1 







Local inn on ii 
48K system 



49151 1$BFFP) 

401:92 ($9000) 
40184 (S9CPo) 



364OT <$96Mi 



Note 1. Thin memory uren Is not n fleeted when booting * Slave diskette: 
DOS 1* plated directly below the: Highest RAM Memory oddresti that was 
available on the system that INITlallzed tha Slave diskette , whether 
appropriate to the present system or not. 



140 



B. MEMORY AREAS USED BY DOS AND EITHER BASIC 



Highest RAH 
memory address; 

49151 (SBFFF) ~ 
on ,i 48K uyfil i-rt 



L- 



24576 
(?6fW0) 



16 384 

CS400fl) 



8192 

(&ZM01 






2048 _ 

($0840) 



Lowest RAH 
menorv address: 

tmuy ' 



10752 

C52Atfl*J 
bytes 



Disk 

System 
(if booted) 



Integer BASIC 
program lines 
start at HIHEH 
and build down 

J_ 



Applesoft 

at rings 

start at IHHSM 

and build down 



High-resolution graphics, Page 2 
I Koce 5 ) 



High-resolution graphics . Page 1 



[ Not.? 4 ] 



T 



Either BASIC'S 

variables 
start at I.OMEM 

. i i Sin l Id tip 

Applesoft T 

program lines | 

push LOMEM up | 

I 



Diskette 

Afl|il iT.rrf t 

(If used) 
occupies 
this a pace 

( Note 4 ] 



BASIC System use: 
1 o v-rcsolu 1 1 on gnphl Cf 
and text screen, etc- 



Without DOS. 
either BASIC 
'oel» HlHKM her* 
I Note 2 J 



Boating DOS 

sets K1HEH hire 

[ Note 2 J 



FP (diskette) 

sets LOMEH at 

12291 (S3M3) 

| Nate 2 J 









FP (firmware) 

and INT aet 

LOHEM here 

[ Nota 2 ] 



Note 2i If your syateo is in Integer BASIC, the HLMEM pointer can be 
lound (low byte first, then high by ce) In locations 76-77 (S 4C-54D). IE 
your system is in APPLESOFT BASIC, the HL1£H uoOntex. IB _iaJ.OCationB 
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115-116 ( T 73-S74), same format. Sec Table 2 for the value of HIHEM set by 
boorltig DOS. Increasing MAXFILES will move HIMEM down an additional 595 
bytes for each file buffet added. For the locations of other Applesoft 
program pointers, consult your Applesoft II BASIC Programing Hanual, 
Appendix I. 



TABU 2: HIMEM VALUE SET BY BOOTING DOS 



When DOS is booted, HIMEH 16 aet according to tt 
System: 



amount of memory in the 



System 


Highest 


RAH address 


SlM 


Dec loa 1 


Hexadecii&al 


16K 


16383 


$3FFF 


20K 


205 79 


$4FFF 


24K 


24575 


S5FFF 


UK 


32767 


S7FFF 


36K 


36863 


S8FFF 


ASK 


49151 


JBFFF 



HI HEM i set by DOS boat 

Decimal Hexadecimal 



5632 


$1600 


9728 


$2600 


13824 


53600 


2281$ 


$5600 


26112 


$6600 


-27136 


$4600 [ . 



Note 3 



Note J. The number -27136 could also be written 38400, but Integer BASIC 
will not accept numbers greater than 32767. In Integer BASIC, memory 
addresses greater than 32 767 must be expressed as their negative 
equivalents. The negative equivalent of any positive declaal address n le 
f n - 65536 ). 



Kore 4. Using lilgli-ri'jji.Lui inn graphics Page I erases the concents of 
memory locations 8192 through 16383. Unless DOS sets K1MEH to a value 
greater than 16383, nn attempt to U9C -' l^h-refiolution graphics Pag* 1 vSll 
erase part of DOS. Thla means that you cunnot "■»• liir.k II and 
high-resolution graphics at the same time, unless your system contains at 
1*4»C 32K of memory. 

If you are using diskette Applesoft, an attempt to use high-resolution 
gruphlcu Page 1 vlll erase part of Applesoft- With diskette Applesoft, 
you asy use high-resolution graphics Page 2. only, if your system contains 
at least 36K of meoory. See Note 5. 

Note 5, Using high-resolution graphics Page 2 erases the contents of 
memory locations 16384 through 24575. Unless DOS sets HIHEM to a value 
grentt-r i linn 24575, nn attempt to use Mflh-reaolution graphics Page 2 may 
erase part of DOS. This means that you cannot mm Disk II and Page 2 
high-resolution graphics at the sane tine, unless your system contains at 
least 36K of memory. 
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APPB4DIX 

DOS ENTRY POINTS 
AND SCHEMATICS 



144 DOS Entry PoinLa 

145 Circuit Schema; sk IT Interface 

146 Circuit Schematic: Disk II Analog Board 



DOS B4TRY POINTS 



Routine to re-connect DOS (if page 3 Is over-written): 

System Decimal address Hexadecimal address 

nit.* ( <:m.i. ) ( c ) 

48K -25153 STOBF 

32K 23999 S5DBF 

INK 7615 $1DBF 

The Monitor command 3D8L displays this number at the top right* 



locations containing the start address and length of a BLOADed program: 

System Stort address (low byte) Program length (lew byte) 

size Decim al tlexAde ctMj. Declnal Hexadecimal 

48K 4%34 SAA72 43616 SAA60 

32K 2725(1 $bAJ2 27232 SSA6B 

loK 10866 S2A72 10846 52A69 

To see the startlnx addrcw "r length after a BIAAD, type 
PRINT PEEKdflH byte) ♦ P£EK(lotf byte +1)*256 

Program to find the l»8 locations containing the starting address 
and length of the most recently BLOADed prograo, on any aii<s system: 

i - 

-f> 
20 

D*» "BLOHD FOO" 

IF PE 9 OR Pf ■ 

EN NEJ 
START 

fla FOR I - 1*0 T 

10. 
The udluea of H and T (lines 7 and 8) are shown for a 48K tiyulrm. 

Appendix D, page 142, shows the correct values for your system- 
Thin program lnki's about 2 minute* in find Ibr doaired locations. 



DOS character Input and output routines: 

See. Chapter 19, cxpev lolly Nate 7 on pnge 195. For an citomplc 

using the technique described, see the program on psge 151. 
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CIRCUIT SCHEMATIC: DISK II INTERFACE 



iM 



1 

-It-* 






T 1 

i-o- 




H 



-(til 



1 



E 
I 
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CIRCUIT SCHEMATIC: DISK II ANALOG BOARD 



, . .IS. 

oie 



;: 
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•a 



~~M 



i 



tf 
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i 
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fc 
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d 



*3 



^ 
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i 



3* 



s> 
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bfcS 



! f 

5 * 



if 
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APPENDIX 

SUMMARY OF DOS 

COMMANDS 



14 8 Notation 

151 Names 

151 Housekeeping Commands 

156 Access Commands 

153 Sequential Text File Commands 

161 Random-Access Text File Commands 

163 Machine Language File Commands 



The DOS c unwinds ere grouped into 5 categories in this appendix: 



Houaekppplng commands 
INIT KENAME 

CATALOG DELETE 
SAVE LOCK 

LOAD UNLOCK 

RUM 



VERIFY 
MON 
NOHON 
HAXFILES 



Access Commands 
FP pr; 

INT IN* 



CHAIN 



Sequential Te«c__Fil«i Coimandg 
OPEN APPEND 

CLOSE POSITION 

READ EXEC 

WRITE 

Kendoa-Acc eg g _Text File Commands 
:■(':: RKAD 

CLOSE WRITE 

Haclilne Language' Kile CgBJaOMfl 
BSAVE 
BLOAD 

BRUM 

Procedures used in DOS (including chaining in Applesoft) are summarized in 
Appendix G. The notation used in the summaries (and throughout the 
manual) is described In the following section. 



NOTATION 

Synt.ix refers to the structure of a computer command- 
Is used to describe the syntax of each DOS command. 



A simple notation 



Item* in square brackets, ( and 1 , are optional. These Items are 
nonet Iocs colled parameters. Not all commands permit oil parameters, but 
chose parameters chat ore permitted in a given command amy appear in any 
order, unless otherwise noted. 

if a command uses a file name, the file name oust cone inacdlaiely after 
the command word Itself* the rirst item following the command vill be 
trt-utcd us a file name- live file name must be separated by a comma from 
any parameter that follows. 

Curly brackets may he used to indicate Uhen a certain key should he 

pressed: 

{CTRL) hold down tin key marked "CTRL" uhlla another key is typed. 
<CTKL)D means hold down the CTRL key while you type the 
letter D. Sometimes another notation is used: CTRL-D means 
the same as <CtRL>D. 
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(RETURN) press tire key marked "RETURN"- The (RETURN! required 

otter every connsnd ii not shown. 

{RESET) ptvta the key marked "RKSET". 

(ESC) press the key marked "ESC". 



CAPITAL Letters and commas must be typed as shown, lover case letters 
stand for items that you aunt .'ipply. 

f I tie n.rae. This Is from one to 30 characters,. Any rypeable 

character except the comaa nay appear In a file name- The 
first character must be a letter of the alphabet. For more 
rk-l.-i I I ■;, nee the next section. 
Examples: CHESS 

RECIPE 

SUM OF SQUARES 

NSW* 5 

HOW-ABO0T-THI5 

g another file nana. 

Example: SEPARATOR WITH LOU VELOCITY 

b slot number. a specifies the Apple II slot In which the 
disk controller card has been placed (usually slot 6). 

a initially defaults to the slot fron which DOS was booted- 
It subsequently defaults to the Inst value specified for this 
parameter a must be In the range I through 7. 
Fxumplcs: 7 



^S 



If s refers to a slot which does not contain a disk controller 

rtirii, | lu- uysti-m may stop and fl program In mepory wy even 
be lost. See I/O ERROR, in Appendix B, for more details. 

volume number of a diskette. v Initially defaults to the 

voluee number of the diskette froa which the systea was booted. 

It subsequently defaults to the latest value upeeifled for 

thia paraaeter, or inpllcltly specified by a CATALOG command. 

v nust be In flic* rnnKe through 256- 

Example: 101 

Note: A diskette's volume number may not he 0. In a DOS 

command, specifying a volume number of ft or simply V 
with no number In a "wild card" and tells the DOS Co 
determine and use the volume number On the diskette. 

drive number (either I or 2). d Initially defaults to one. 
It subsequently defaults to the latest value specified for 
this paraaeter. 

F.xnaplc: 2 
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position dumber. Used with the R parameter in the POSITION' 
and EXEC commands for sequential text files. p specifies 
a field whose position in the file is p fields ahead of the 
current file position. p defaults to 0, which does not move 
the tile-position pointer in the file. Note: EXEC always seta 
the pointer Co the ttart of the named file, go p iy always 
relative to ft when used with EXEC. See command summaries later 
in this Appendix. p must be in the range 9 through 32767. 

record number. Used with the P. parameter in the READ and 
WRITE commands for random-access, text files. r defaults 
to after OPEN. Thereafter, it defaults to the last record 
specified. r points to an absolute record within ■ randotj- 
access file. r must be in the range through 32767. 

address In RAH* The a parameter is required with the B5AVE 
command. a specifies the starting Apple memory address for 
BSAVElofi or M.OADlng binary inf ornuifinn. If R1.0A0 does not 
specify an a parameter, then the value of a defaults to 
that used when the binary file was BSAVEd. a must be In 
the range ft through 65335. 

byte number. b defaults co 9. In a sequential file, b 

points to an jibstiltitc byte within E In- fill-. In « random— access 
file, h points to jm fibsolnr i' byte wttliln the record pointed 
to by r . b qimt be In the range to 32767. For most 
applications b is in the range 9 through the lest byte in 
the current sequential file or the last byte in the current 
random— access record* 

length specifier. J defaults to 1. When used in the OPEN 
command with random-access files, j is required and specifics 
che number of bytes that will constitute a record in a randoo- 
access file. When used with the BSAVE command. J is required 
and specifies the number of byces of Apple memory, starting at 

address a , whose contents are to be stored on diskette. j 
must be in the range through 32767. 



As an example of this notation, che DOS command that is nocated 

1KIT f [,W] t.SsJ [,Dd] 

can be interpreted as 

IN IT HELLO, .'17 . D2 

by che following, process. The keyword "1KIT" Is in upper case, and must 

be typed exactly ■>•■ shown. In the syntax description, "i" is lover case 

and stands for a file name -- it Is replaced by the legitimate file name 

"HELLO" In this example. Th« ",V17" la optional. "V" stands for 

"volume"; 17 was chosen arbitrarily as a volume number for this example. 

The notation ",Ss" is optional and omitted. The notation ",Dd" becomes , 

D2 in this example. Indicating chat disk drive number .' 1 1 I hi- used. 

Any numerical constant in a DOS command csn be entered In hcxndi-cim.il 
notation by preceeding the hexadecimal digits with a dollar sign. 
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FILENAMES 

File names nay be up to 3fi characters long, and oust begin with a letter. 

The name cannot contain a comma, a CTRL-M or a RETURN, which Is used to 
terminate the command. Spaces that precede the flrnt non-space character 
In a name are Ignored. All name characters beyond the 3?th are igmire-d. 
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When typing file names, the use of special keys Such as fcSC, the 
left-arrow and right-arrow keys, and certain keys typed with the CTRL key 
("control" characters CTRL-C, CTRL-H) may have unexpected effect! , 



$ 



If a file nana contain* control characters, you won't fee then printed, 
but they mat be typed to use or delete the file. 

The following Applesoft program can be used to find any hidden characters 
except CTRL-H (RETURN), ESC, CTRL-H (left arrow) and CTRL-U (right arrow). 

■ 
- 

Ft* 1 

88 POf 

ff you suopect you may hove arrldenlal ly Introduced a control character 

into b file nBoe, type this program. SAVE It, and RUN Ic- The Applesoft 

prompt ( J ) will be displayed. Next type 

CATALOG 

and you'll gel. a I I'll of all i In- files, with any control characters shown 

as flashing characters. Control characters In progr.-im Hating* can also 

be found thii way. To re-Instate normal printouts, type 

I'H" ',1 



HOUSEKEEPING COMMANDS 

[KIT r [,Vv] f,Ss] [,Dd] 

Kxnrople: 1K1T HELLO, V1H 

The parameter v assigna a volume number to the diskette being Initialized- 
Details on Initializing diskettes ore in Chapter ? and Appendix G. 
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CATALOG [,5sJ [.D-d] 
Example} CATALOG 

Displays on the screen the volume number and a list of all files on Che 
diskette -In the specified or default drive. The ilr-f.cn 1 1 vol imp nuaher Is 
changed to natch that of the indicated diskette- If this coamand ubcs a 
vol urn; parameter ti^v] that parameter is ignored. 

With each file is displayed an indicator of its file type and the number 
of diskette sectors occupied by the file. The flit* types are: 



I 
A 

T 



Integer BASIC program file, created by SAVE- 
Applesoft BASIC program file, created by SAVE. 
Text flic, created by OPEN and filled by WRITE. 
Binary nu.'mory-liMge tile, created by BSAVE, 



An asterisk beside a file's type Indicator shews that the file Is LOCKed. 

A maximum of ffli diskette sectors are available to the user. Each 
diskette sector can score up to 256 bytes of information. The mlnlnum 
length of a file la 1 sector, for an empty text file. (Technically, tb.it 
I sector la occupied by the empty track /sec tor list for the file.) Empty 

integer BASIC, Applesoft, and Machine Language files cake 2 sector*. U 
for the crack/sector list and i for the first program sector, which 
contains the program's length- See Appendix C for mere details.) 



<$ 



If an lndivtdn.il file eXCQOds 2M vectors, the CATALOG display 

file's length starts over at 0M, This does not affect use of the file. 

hut nu«y give nil c-rnini-wis imjiri'SMlnn Of how full I In- illnkellp JfJ. 



SAVE f [,Ss] [,Dd] [,Vvl 
Example: SAVE COLOR DEMOS, V56 

If there 1m no fllr with the specified file n.arae on the diskette in the 
specified or default drive, a file is created on that diskette and the 
current Integer BASIC or Applesoft program is stored under the given file 
mm*. I| ih<« rltfikfl ( ftinmlns n ftli- with tlu? specified file name, but 
of a different language or file type, then the message 
FILE TYPE MISMATCH 
will be displayed. 

S 

If tile* rlinfieii cli*iki-ttp nlrcndy oontnlnft n f 1 1 e with the specified file 
ruinc, iiml In lln 1 ruimi' I iHiftuflftp, the or Iftfciuil fjli'Vi font i*nt •■ are lost and 
the current BASIC program Is saved In Its place* Ko warning Is given- 
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LOAD f [.Si] [.Ml f,Vv] 

Example: LOAD DOW JONES. VI 9. El 

Attempts co find Integer BASIC or Applesoft program fill with none f on 
the diskette In the specified or default drive. If the volume numbers 
match and there is such a file, that program will he LOADed Into the 
computer. It cm then he LISTed, or RUN, or SAVEd as with any program. 
LOAD rlwiix any open text files, changes the Apple to the correct language 
lur file f , and erases any program In memory before placing the new 
program In the Apple. 

If file f is an Applesoft BASIC program, and Applesoft Is not already in 
memory or available from the Applesoft firmware ROM card, the program 

Applesoft will be LOADed and RUN from the specified drive automatically, 
before file f la LOADed. If Applesoft is not on that diskette nor on 
the firmware ROM card, the meiaage 
i.ANCilJACK wrr AVAILABLE 
will be displayed. 

The Instruction LOAD, without any parameters will LOAD a program from 
cassette tape. 



RUN f I.Ssl J.Dd] [.Vv| 

Example: RUN ANNUITY, D2 

LOADS file f from the Specified or default drive (see the previous 

discussion), than alio RUN* the program loaded. If juit 

BUN 

In typed, the program in memory is RUN. 



RENAME f, g [,Ss] (,Dd] [,Vv) 

BXUpl«g RENAME SEPERATE, SEPARATE, S4, Dl, W» 

Finds the file named f on the diskette In the specified or default 
drive, and changes its name to g . The file's contents are not affected. 

If file f was open, It Is closed. 
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RENAME does not check to see whether th* file name g ii already in use, so 
it is possible to use RENAME to put several filei of the lime name onto a 
diskette — a potenl lolly confusing situation, at beat. 

Do not REKAHE the greeting program that wis created when the disk was 
iNlTlallzed unless you've first changed the name using the UPDATE 3-2 
program. Otherwise, DOS will continue to look for the old greeting 
program name, each cine you boot the lyitem with this diskette in drive 1. 
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DELETE f |,Ss] [,Dt3] l.Vv] 

Exjnple: DELETE TEST 

Keooves the file nosed f from the diskette in the specified or default 

drive. Lf f yus open, this command closes It. See Append!* C lor mare 
details of the deletion process. 



$ 



If • file named, f docs not esiet on the diskette, the message 

FILE NOT FOUKD 

will result. To avoid this occurrence stopping yaur programs, first OPEN 

the file, then DELETE it. 



LOCK I [,5i] [ t M] I.VvJ 

Example: LOCK LOVE LETTERS, V3I 

This command allows you to make file f , on the diskette in the specified 
or dofaulc drive, safe from accidental deletion or change. A LOCKed file 
la indicated Is the CATALOG by an asterisk ( * ) . 



UNLOCK f [,5u] I.Dd] I.Vvl 
Example: UNLOCK RECIPES, V31, 02 

It you change your mind, and want to alter or remove a LOCRod file named 
f , on the diskette in the specified or default drive, this cowmnnd allows 
such a change* 



VERIFY £ |.,Ss] |,Dd| [,W] 

Example: verify sam 

Performs a cheek Ilini the Information actually stored On the diskette in 
file f is self-consistent. (Technically, this Is "hot happens: When 
the file is created — with SAVE, BSAVE or WRITE — DOS c.l.-nl.ites a 
checksum byte Tor the contents of each output buffer and then stored that 
byte with the buffer's contents in a diskette sector. The VERIFY command 
calculates a new checksum byte for the actual contents of each file 
sector , and compares It with the checksum byte originally stored with that 
sector.) If a file VERIFYs, no message is given: it' 9 safe to aeiuuac the 

information nn the diskette has been stored correctly. If a file does not 
VERIFY, the message 

I/O ERROR 

Is presented. You may VERIFY any type of file. 
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hon rci I. II [,0] 

Exanplee: HON 

HON C, 1,0 

All disk commands and all information sent between the computer and the 
disk are normally not displayed an lire screen. This command allows you 
to enable some or all of this display — n hclpiul tool when debugging a 
program. If C Is specified than disk commands arc displayed. If I 
is specified, then information being sent from the disk to the Apple, as 
Apple'* Input . will he displayed. If la specified, then information 
being sent to the disk from the Apple. 09 Apple's output . will he 
displayed. 

At leant one of the three parimetera must he preflent, or MON is ignored- 

The parameters may appear in any order, separated by commas. These 
j>.»r,irati-rii appear only in the cOmmmidft HON and NOMON. 

Note: HON remains in effect until a NOMON command, a change of language 
(FP or INT), a boot, or a restart (3D0C). Even RUNning. a program won't 
cancel a HON. 



NOHON [C] |,1) [,0] 

Examples; HOHON C 

KOMON I, C 

The HON rommnud i-nnhli-n yciu in il I r.ji 1 .1 y dink ruMuanda and/or information 

Rent between the cimpuCcr and the disk: such information is not normally 

displayed On the screen. The KOHIIN command allows, you to disable some or 

all of thin display. The command 

NOMON C, I, 

returns the system to its usual, default state 

If C Is specified then disk commands, are not displayed. If I la 
specified, then information being sent from the dink to the Apple, as 
Apple's inpu t, will not be displayed. If Is specified, then 

information being sent to the disk from the Apple, as Apple's output , 
will not be displayed. 

At least one of the three parameters must be present, or NOMON in 
ignored. The parameters may appear in any order, separated by commas. 
These parameters appear only in the command! MON and NOHON. 



HAXmES n 

Example: HAXFILES 6 

n is an Integer from I to 16 that specifies the number of files chat can 
be active at one time. When HAXFILES Is executed, 595 bytes of memory 
(called .1 file buffer) are reserved for each file. When you boot the 
;iy«ti-m, n defaults in J, so that you will have 1765 bytes reserved for 
file buffers and will be allowed n hikShub of 1 files open simultaneously. 
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All DOS commands except PR*, 1N# and HAXFILES require a file buffer. Thus 
if you have MAXFILES 1, and Dne file is OPEN, an attempt to perform a DOS 
command (such as CATALOG) will cause the message 
NO BUFFERS AVAILABLE 
co be displayed. 



fffs 



Use of HAXFILES moves HIMEH. This can cfttau Integer BASIC programs or 

Applesoft strings. Use MAXFILES before LOADing and RUNning a progran. 
See the discussion in Chapters 5 snd ? if HAXFILES most be used from 
ulililn e program. 



ACCESS COMMANDS 



FP |,Sft] [,Dd] [,Vv] 
Example: FP, D2 

Thin coDuuind puts your eyateo Into Applesoft BASIC. Any Integer BASIC or 
Ann lefsiiTi program in memory In lose. If your computer contains the 
Applesoft firmware card, COS uses that source tor the language, regardless 
of the switch position on the card. If your system does not contain the 
Applesoft firmware card, D05 atteopti to load and run the program named 
APPLESOFT on the diskette In the specified or default drive- 
To place the APPLESOFT program onto a newly initializer! diskette, first 
LOAD the APPLESOFT program from the Master Diskette, then (without RUSinlng 
or LISTing the file) SAVE APPLESOFT on an initialized diskette Ymi mint 
USB the name APPLESOFT for this file. 
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Bo not use RUN APPLESOFT to change languages. Everything dunks fine at 
first, In" DOS has not properly initialized the language. To ovoid the 

resultant ness, BiwayB use FP. 



1KT 

Rxmnjlei INT 

Thlti rnnmnml puts the Apple into Integer BASIC. Any Integer BASIC or 
Applesoft program In menujry Is lost. 



CTRL-D ( also written <CTRL)0 ) 
Example: Id D5-aiBS<<) 

2(t PRINT DSj"HKlTE CHESS" 
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Every character PRINTed out by eh* Apple Is first examined by DOS before 
It la uont nn CO the nutuldo world. If the Apple PRIHTs out a RETURN 
character (aunt PKIHT ItUMUCI aucooai la illy Md with A RETURK), And the 
iii'at character la a CTRL-D, this is a message to DOS that subsequent 
characters (until the next RETURN) are a DOS conaand. Moat DOS commands 
may be used Iron inside an Integer BASIC or Applesoft program. To do 10, 
PRINT a string consisting of CIRL-D followed by the desired DOS command. 

The recommended way to do this Is to first create a fit ring DS consist 
only of a CTRL-D > and then to use BASIC statements such as shown in the 
example. Note the use of CHRS(4) to c re.it e DS (this works only In 
Applesoft i since the CBS? function is not off erred in Integer BASIC). 
Instead, CTRL-D could have been typed inside quotation narks to create DS,, 
bus in this case no character Is shown between the quotation marks. 

Every chnraeler sent out by the Apple lu first examined by DOS before It 
Is passed on co cha outside world. If the Apple sands out a RETURK 
character (cost PRIKT statements automatically end with a RETURN), and the 
next character Is a CTRL-D, this la a signal to DOS that subsequent 
.'li.iiMt t I'tr. (mil 1 1 I lie ih-xI RETURN} are a DOS coBBAcid. A DOS command from 
a |iriiRriim oust appear In a PRINT si aliment whose first oupul character la 
CTRI.-D and whose output is separated E rom preceding and from succeeding 

printed output by RETVRli's. For additional Information, see "Use of DOS 

from within a Program", in Appendix C. 



Exanple: PR* 6 

Sends subseqiini I Apple output to the device controlled from slot I a » 

Instead of to the TV screen. The command 

PR* D 

returns output to the TV screen. If the command is used from inside 

programs, it miM ^igipcir an n PRINTed TOOK rnmmanrl, as shown belnw: 

1(9 DS- M,, i REM CTKL-D 

20 PRIKT DS; "PR* I" 

if nn device controller card is Installed in slot * s , the system may 

"hang" and you'll have to press the RESET key to recover 



IN* a 
Example: IK* 6 

Takes: subnequenl Apple input from the device controlled from slot # « i 

instead of from the Apple keyboard. The command 

IN* 

resets the normal keyboard Input. If the command is used from inside 

programs, it must appear in a PRINTed DOS coooand, as shown below: 

Id D$-"": REM CTRL-D 

23 PRIKT DS; "IK* I" 

If no device controller card is installed In slot I A , the system may 

"hang" and you'll have to press the RESET key to recover - 
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CHAIK f [,Ss] [,Dd] I.Vv] 

Example: CHAIN PART TWO, Dl, S7, W$ 

Used from within an Integer BASIC program, it loads and runs the Integer 
BASIC program named f on the diskette In the specified or default drive, 
but dee* not clear the values of any variables- Tlila moans that program 
t can operate on the results of the previous program, and con leave data 
for any following program- You cannot CHAIN Applesoft programs using this 
command: see the special procedure for Applesoft programs In Chapter 10 or 
Appendix C. 



SEQUENTIAL TEXT FILE COMMANDS 

OPEN t [.Sa) [,DdJ [,Vv] 

Example: OPEs SESAHB, M 

Allocates a memory buffer of 595 bytes to the text file f , and preparer 
the system to write or read from the beginning of the file. This 
command la used with the WRITE and READ coummnds to create and retrieve 
■equftai i.il t me) Ellee. 

If there la no file f on the diskette In the specified or default drive, 
one Is created. If a file named f ia already OPEN, this command first 
CLOSES that file, before OPENing tin- aerified file. 

CLOSE [f] 

Example: CLOSE WINDOW 

if you were WRITElng, a CLOSE causes nil remaining character* in the 
output pnrt or the file buffer to b* tent to the diskette Specified when 
thai tile was. OPBKed. CLOSE f deallocate* the buffer associated with the 
sequential text file f . If CLOSE is wed without a file name, all OPEN 
files will be closed, with the exception of the EXEC (lie- (There can 
urily he one EXEC file OPES at any time. When another Is implicitly 
OPENed. the existing EXEC Elld K any, is automatically closed J 

If a program is Interrupted by a CTRL-C vhile a text file Is OPEN, It's a 

good idea to type 

CLOSE 

to keep any data from being lost. 

$ 

Files that hove been allocated by tin OPEN statement must be CLOSEd. 
Failure tn CLOSE » ! 1 le that was OPENed and written to (by a WRITE) can 
result fn luii-i nf data. 
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WRITE f l,Bb] 

Example: WRITE ADDRESS. DATA. 

After this coannd, PRINT etatcotmtA nend their output to the specified 
file instead of to the Applc'si TV nr-ri-i-n. With the Byte parameter, 
WRlTKlriK begin* At the b-th byte of the file (see Chapter 6. page W)« 
WRITE Lfl cnnrrl led by the printing, of any DOS command, or by an INPUT 
statement. The null tX)S numiuintl (simply PRlKTlng a CTRL-D) will do. 
UR2TE aniflt be laaued In deferred-execution node. 
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After this command all Apple output characters that would normally be 
displayed on the screen <ire Mill to the illf.ket c c in fit end. Thia includes 
INPUT question-mark prompts, error messages, and other unwanted 
characters. 



HEAD f t.BbJ 

Example: READ SESAME 

After this command, INPUT statestecta (and GET statements In Applesoft) 
obtain their response characters froa the specified sequential text file 
instead of fro* the Apple's keyboard. With the Byte parameter, KKADing 
b eft In* at the b-th byte of the file (see Chapter 6, page 69). 

INPUT causes characters to be BEAD from the sequential file one fluid at ft 
time, h field consists of from 1 to 32767 characters, ending »Uh n 
RETURN character. However, because of the limited capacities of strings 
and input/output buffers, it is very difficult to store and retrieve 
!•> nf more than 255 thai m i i ■<-.. 

READ la cancelled by the printing of any DOS command. A null DOS command 

(Juat PRINT a GTKL-O) will cancel READ. The READ command mist be used In 
rieferred-exeriillnn mrnte. 



APPKNT1 I |,Ss.l [,f)d] l.Vv] 

Exaople: APPEND MORE INFO 

Thia coaaund opens the specified text file, but places the 
posltlon-ln-the-f lie pointer to the end of the file. After this 
mound, the next character written Into the file will follow th« laat 
sequentially written character presently in the file. An APPEND mint In- 
followed by a WRITE to the file of the same name, (APPEND must not be 
followed by OPES, because OPES will reset the poaition-ln-the-fila pointer 
back to the file's beginning,,) 
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POSITION f [,Rp] 

Biample; position address .data, »277 

POSITION places the positlon-in-the-file pointer at the beginning uf the 
p-th (Laid following the one you're In. A field Is a gftqu«nc« ni 
characters terminated by a RETURN. Sii!u..t|.u hi kKAU-j nr whites will 
proceed from chat point in the Til.- f. 

POSITION deals with a relative, not an absolute, position, since you count 
fields forward from, where you arc In the file when the POSITION is 
executed. 

POSITION actually scans forward through the contents of the file, 
character by character, looking for the p-th RETURN character' It then 
places the positlon-in-the-flle pointer at the first byte following the 
p-th RETURN character. If, in this search, it finds any byte in which no 
character ha? ever been scored, the message 
END OF DATA 

Is given. Normally, Unix mrurr, utwn the p-th field ahead of the current 
position In tha file is beyond the file's last entry. 



EXEC f [,RpJ t.Sa] [,Dd| [,\v) 

ExampU: EXEC UTILITY 

Similar to RUN, except chat f la a text (data) file containing BASIC and 
DOS commands as they would be issued from the keyboard. This allows you 
to sec up files that can control the Apple, much ai you would control the 
Apple yourself. 

There can only be one EXEC command in effect at a time. If the EXEC file 
contains the Immediate-execution coianand EXEC, the original EXEC file Is 
cloved and the new PXKC file Is opened and executed. If EXEC has OPEKed a 
file, the coumand 
CLOSE 

will nut CI.OSK i In- tile being BXEC'ed, When an EXEC file has completed 
all Its commands. It CLOSES itself and stops. If a file being EXEC'ed 
contains a command to RUN any program, EXEC waits patiently until the 
program ends. Then the next command in the EXEC file is executed* 
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However, If a program is running while an EXEC file is open, any INPUT 
statement in the progran will take the next field from the EXEC file ■■« 
the response, ignoring the keyboard. Worse yet. if that response l;> an 
Immediate-execution SOS command, the command will be executed before the 
progran continues- 
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If you type CTRL-C to Stop an Applesoft program that is running while 
EEC file in still open, the regaining commands In the EXEC file will 
usually not be executed. 
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It ynu specify die value, of the R parameter, a position-in-che-f 111 
pointer is placed nt the Resinning of the p-th field in tin- file, and EXEC 
will icirt executing from this point in the file. 

Al With POSITION, the R parameter used with EXEC should he though! at as 
the Relative-Held position parameter. However, mil Ike POSITION, EXEC 

a lvava counts llelds from the beginning oi your file, so p in .tlWiiyA 
relative to 9. The other parameters work as usual. 

If you specify the value of the R parameter beyond the end of the iile 
you'll get an 
END OF DATA 
message. 



RANDOM-ACCESS TEXT FILE COMMANDS 

OPEN f, LJ t.Sn] [,Dd| [,Vv] 

Example: OPEN SESAME, L2 

OPEN nUocutes a 595-byt file buffer to the r an ilasr-a cress text file f , 
and nci the ncord length to the number of bytes specified by J - The 
number J rust be In the range I to 32767; J default! to ■• 

OPKN la ufted with the READ gad whin . •■ i ,. • i ■■ . iv.it c- and retrieve 

random-occcBB text flK-a. Note thul the I* (Length) pnrom.-f.or in not 
optional: by definition, you must specify the record length oi a 
random-access tent Ml*. Each tine you use a particular random-access 
text file, you must OPEN the file with the saoe L parameter value. DOS 
then uses that value to calculate the starting position of any specified 
record< 

if there IB no file i. One is created. 



CLOSE If) 

Example: CLOSE BOOK 

If you were WRITElng, a CLOSE causes all roranlnlnR rlwtr/ictcra ir, tin- 
output part of the file buffer to be sent to the diskette In the drive 
that Was specif lej when the file was QPENed. CLOSE de-.il I mates the 
buffer associated with the random— access text file £ • if CLOSE Is used 

wit boat a Ella naae, ill (MM ELlee wtJJ be .-|o«ed 4 with the exception of 
an EXEC file, if any. 

If a program In interrupted by a CTR1.-C while a text file in OPEN, it's .1 

good idea to type 

CLOSE 

to keep from losing data. 
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Files chat have been allocated by an OPEN statement must be CLOSEd. 
Failure to CLOSE a file that was OPENed ,<ind written to (by a WRITE) can 
result in loss of data. 



WRITE I [,Rr] [,Bb] 

Example; WRITR ADDRESS. DATA, K3 

After this statement, PRIST statements Send their output to the specified 
file instead of to the Apple's TV screen- WRITE is cancelled by the 
printing of any DOS command, or by an INPUT comoand. The null DOS command 
(simply pRtHTing a CTRX-D) will atop a WRITE with e mlnimim ol effort. 
WRITE can be used only 1« deferred-execution PRINT statements. 

The R (Record) parameter rause.s the WRITE to begin at the first byte of 
the r-th record, where each record contains the number of bytes, J . 
specified by the L parameter given with OPK.N. r defaults to 0. If 

the B parameter Is specified, the WRITE will begin at the b-th byte of 

the r-th record in the. file. 
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After the WRITE statement , ,1 1 I ApjiU- uuiput rharactera that would 
normally be displayed on the screen are sent to the diskette iits-C ead . 
Tlilfi Includes INPUT question-mark prompts, error messages, and other 
unwanted characters. 



READ f l.Rrl t.Bbl 

Example: READ SK,SAHE,R3.B30 

After this statement, INPUT statement* (and GET statements in Applesoft) 
cilii.un their response characters from the specified random-aceefis text 
flic instead of from the Apple's keyboard. INPUT carmen characters to be 
REAP from the rondom-acccss file's current record, one field at a Clue. 

A field can be from I to 32767 characters, ending with a HETDRK character. 
However, no record should be more than J characters in Length , where j 
is the record length specified when the file was OPENed. 

The R (Record) parameter causes the READ to begin nt the first byte of the 
r-th record, where each record contains the number of bytes, J , 
specified by the L parameter given with OPES- r defaults to j). if 
the B parameter is specified, the READ wilL begin at the b-th byte of 

I he r-lli reiMird In [In- ! I le. 

READ is cancelled by the printing of any DOS command- A null DOS command 
(.hist PRINT a CTR1.-D) will cancel READ. 
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MACHINE-LANGUAGE FILE COMMANDS 



RSAVK f. An, Lj t,So] |,Dd| [,Vvj 

Examples: BSAVE PICTURE, A163&4, L8192 
BSAVE PICTURE, ASAUlHf, LS2Sf00 

Creates a file milked f , And mores the contents of a segment of the 

AHPT.E I['b memory. The segment Is specified by the starting address a , 
and the number of bytes to be stored J . 

The examples ahovn above store a high-resolution picture, Iron the second 
high-resolution picture nrco. They are operationally Identicals the 

Rftrind I'x.inpli- |imt lines hi-x.'irir<- I ma I notation for I lie parameters. 



BLOAD f r.Aa) r.Sal E.Od] [,Vv] 

Examples! BlflAU PICTURE, A8192 
BLOAD PICTURE, A$20fW 

If a 1* not specified, then bload places the specified file In Apple's 

memory beginning at the start tun, Uu'iitUni itf the memory area that Was 
originally BSAVEd. If ■ i» specified, then the data In placed in 
Apple's memory beginning at address a • Note that a machine-language 
program may no longer be executable If so moved. 

Assume that a a high-resolution graphics picture has been BSAVEd on n 
diskette under the file name PICTURE. Then the first example shown above 
would place the picture into th* first high-resolution picture nrw, ulilih 
■tacts at memory location #192 (decimal). The second example is 
equivalent: the address is shown in hexadecimal* ot» Indicated by the "$" 
before the 2000. 
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Either example would clobber any version oi Applesoft chat is not In 
firmware. 



BRUN f J.Aa] [,Ss) |,Dd] [,WJ 

Example: BRlffl SUPER. ASC0A, V75 

BLOADs the file t into Apple's memory beginning, at location a - If the 
A parameter is omitted, the file Is BLOADed starting at the same 
location from which It una RSAVEd. Once BLOADed, the file (which should 
be a machine-language program) lis started by a machine- language jump (.IMP) 
to location a . 
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APPENDIX 

SUMMARY OF DOS 
PROCEDURES 



Booting DOS 

INITializing a Diskette 

Recovering from Accidental RESETs 

Use of DOS from within a Program 

Creating a Turnkey System 

Creating and Retrieving Sequential Text Files 

Adding Data to a Sequential Text Fi 

Controlling the Apple via a Sequential TexL File 

Creating and Retrieving Randnm-Arcess Text Files 

Copying a Text File 

Chaining in Applesoft 



This appendix contains summaries of the main procedures used In DOS. On 
the preceding page these are 1 laced with the page numbers on which they 

appear' 



BOOTING DOS 

r!i|i l.ii-t- "n" by rln- slot number In which the disk controller Is located. 

Prompt To boot DOS, 

Character Language type 

> Integer BASIC PRis or XNls 

j Applesoft PRfs or lN#s 

* Monitor s{CTRl.}K or s{CTRl.>P 



INITIALIZING A DISKETTE 

To tSlTiallie a sieve Cnenory dependent) diskettes 

1) Boat DOS 

2) Insert a blank dlek«tt« lnr«i the illfik drive 

3) Typo in a greeting program, e.g. 

1( PRINT "32K SLAVE DI5KETTE INITIALIZED 5 MAY 80" 

20 F.KD 
£•) Assuming you choose to name the greeting program "RF.LLO", 

type the command 

I NIT HELLO 
5) Aftar cha IN USE light on the disk drive gwu »»t, remove 

I In- ill'iW-Iti- .Mitl label it. 

To create a master (memory independent) diskette, see the instructions in 
Chapter 5 tor use nf 'he UPDATE 1.2 program. 



RECOVERING FROM ACCIDENTAL RESETS 

If DOS has been booted and then the RESET key is accidentally pressed, 

type 

3D0G 

(that's the mineral rero after the D) to. get back into th* BASIC you lcii 

with your program Intact. 



USE OF DOS FROM WITHIN A PROGRAM 

DOS comoands may be issued from within a program by PRlNTlng CTRL-D then 
the comand. First create a string DS which consists only »f CTRL-D. 

In Applesoft, US nay he created by the command 

PS - CURS (4) 

since CTRL-D Is the character whose ASCII code is 4. 
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In either BASIC, DS may be defined by typing 

Q$ - " 

then holding down the CTRL key while typing the Letter D, and then typing 

the closing quote- Control characters such «s CTRI.-D aren't displayed, so 

what you'll aee la 

DS - "" 

This Applesoft program displays the CATALOG when Rum 

N 
Only one DOS command may be contained In a single PRINT statement. The 
PRINT statement's quoted contents mint begin with a CTRL-D and end with 
the DOS counand. The CTRL-D muse be preceded by I RETURli {sent 
automatically at the end o£ most PRINT ototcments). 

These comeand* Should only be used In drferrcd-eiiecutlon mode (from within 
a program), appearing arter CTRL-D In a PRINT statement: 
OPEN APPEHD READ 11RITE POSITION 

The commands INIT and MAXFILES arc best used only In Immediate-execution 
made (not from within a progma) . 

other DOT coanands may be used eltiiar In Immediate-execution mode, or from 
within a program where they appear after a CTRL-D in a PRINT statement- 



CREATING A TURNKEY SYSTEM 

To make a diskette that runs a certain program each tin* the diskette 1* 
hooted — In the example we wl 1 1 use the program COLOR DEMO — - use the 
following procedure: 
i) ISITlaltce a blank diskette, using the name HCU.0 for the 

greeting program. 
i) Place a disk containing the COLOR DEMOS program In drive, 

and type 

RUN COLOR DEMOS 

Once you're satisfied the program RUNs correctly, return 
to BASIC. 
3> Put the newly IKITlalized diskette Into your drive and type 
SAVE HELLO 

to replace the old greeting progran by ths COLOR DEMOS 
program. 



CREATING AND RETRIEVING SEQUENTIAL TEXT FILES 

When creating a sequential text file, en OPEK must precede a WRITE j once a 
WRITE is executed, any subsequent PRIST commands" send ell characters to 
the diskette. CLOSE the file when you're done. A WRITE command la 
cancelled by an INPUT or the use of any DOS comosnd in s PRINT statement 
— even just PRINTing CTRL-D will do. 
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Ibis Applesoft program creates a sequential text file naaed SAMPLE whose 
first thirteen fields contain three strings and: the integers 1 through 10! 
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5 REM MAKE SAMPLE 

RErl CTRL 
20 y SAMPLE" 

-ffJNT TE SfirJPt F" 

48 PRINT Crt: "OPEN SfW 
56 PRINT D*J "WRITE SAMPLE" 
60 PRINT -HI HO" 

?H PRINT "OFF TO THE DISK WE GO" 
88 FOR J » 1 TO 1© 
.' 

CLOSE SrWLE" 



If you OPEN a file that already exists and Chen WRITE to it, you will 

overwrite part t>{ the original file. 

This Applesoft program retrieves the file SAMPLE described above, one 
field at a tiae. If you wlah to it* what is being READ iron the disk, the 

c-nnwamt 

HON I 

will cause Input from the (Unit to- he displayed. 

5 REM RETRIEVE SflWLE 
18 E>» ■ REM 

- 
23 PPINT D* i "OPEN SFU1PLE" 
28 PRINT D*> "RERD SHMPU- " 

>T fl*.BJ. Cl 
50 FOR I = 1 TO 10 
60 INPU1 W 
70 NEXT I 
88 PRINT tW. "CLOSE SAMPLE" 

An OPEN oust precede a REAL. Once a READ is executed, any subsequent 

INPUT statements (In Applesoft, GET* alee) obtain their response 

characters iron the diskette instead of from Hie Apple's keyboard. CLOSE 
the file when you're done, 

A READ is cancelled by PRlKTlng CTRL-D, whether or not it'» followed by a 
DOS command. 
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ADDMQ DATA TO A SEQUENTIAL TEXT FILE 

This Applesoft prngrnm nddiv the tue fit rlnRf. "TEST 1" and "AND HOW FOR TEST 
2" to the end of a sequential lent flic Ballad SAMPLE. Each string Is In 
■n additional field of the file. 

5 REM APPEND SAMPLE 

10 i . I -D 

20 PRINT t»; "APPEND SAMPLE" 

30 PRINT 0»; "URITE SAMPLE" 

40 PRINT " 

30 PR TNT M FOR TEST ?" 

60 PKINI E" 

CONTROLLING THE APPLE VIA A SEQUENTIAL TEXT FILE 

When RUN, thin. Applesoft program creates a text file twined DOIT containing 
the rnnrmiimlr. 

LIST 2fl.5SI 

RUN HELLO 
CATALOG 

3 REM MRKE DOIT 

10 

20 PRINT D*J "OPEN DOIT" 

38 PRINT D*, 'V 

-10 PRINT "LIST £0,30" 

50 PRINT "RUN HELLO- 

60 PRINT "CfiTKI 

79 PRINT D*i "£ 

Once the text file MJJT Is created, the eOMMBd 

RXBC U01T 

will cause the comnands In the file DOIT to he executed one by one, Just 

as if they'd been typed in front the keyboard. 
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CREATING AND RETRIEVING RANDOM-ACCESS TEXT FILES 

This Applesoft program creates a random-access text file named RA-FlLE, 
whose records are each 3(1 bytes long. Then It WRITES the string "NAHE 
ADDRESS" followed by the record number, Into records 12 through IS of the 
file. In lines 70 and 80, record number 13 1b changed to contain th« 
string "IIOS VERSION 3.2". 

,-■ -;... : | , T[_ E 

IB M = CHRf L-D 

28 PRINT Dft "OPEfl Kft-FILE" 

J© PRINT C'*> "DELETE PH-FILE" 

•10 PRINT Os.. "OPEN Pri-FILE. U8" 

36 FDR r = 12 TO 13 

S0 PRINT C>*. "WRITE RA-F1LE- RM 

TO PRINT "NfittE RDDRE 

88 NEXT I 

90 Pt -WRITE ftfi-FILE. Rl3" 

100 PRINT "DOS VERS! 

110 PRINT [•'*■ "CLOSE E" 

This Applesoft program READS records 12 through 15 of the random-access 
text file RA-FILE* Hote that you must specify each record before REAIUng 
it in line 40. Line 60 examines: the three leftmost characters of the 
Input string A$ t tnken froo em-h record. If those three characters are 
"DOS", the message "KKCOKD r WAS CHAHCBD," la PK1SW, and the search 
continues. 

5 REM RETRIEVE Wr-FILC 

Efl CTRL-0 
PRINT 0*j "OPEN Pff-FILEv I 
38 
40 PRINT D*> "READ Rfl-FILT 

Ml 

£0 IF LEFT* <f)», 2) = "COS" THEN 
PRINT "R£C 

NQei 

70 NEXT J 

80 5E Rfl-FIl 
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COPYING A TEXT FILE 

Moving a HASH: 01 I binary program lil>- in ,-inutlnT illiki-iti I:, mi problem: 
just LOAD or BLOAD the file's contents Into the Apple, and then SAVE or 
BSAVE those contents back, onto the other diskette. However, there 1* ao 
such simple way to move 6 text file onto Another diskette (aside from 
COPYing the entire diskette}- In general. « progrars must be written (or 
the specific text file to be moved, which does the following! 

1. READs each field of the existing text file Into en 
Applesoft fitting army. 

2. MUTES each element of the string array into a field 
of the new text file on the other dlskrtir. 

For instance, the previous Applesoft progran RETRIEVE HA-FILE can easily 
be Modified in do K«p I. Just odd tlu>Be two lines: 
7 dim A$U5) 
50 INPUT A$(J) 

And that modified program can easily be modified to do seep 2: Just change 
READ (line 40) into WRITE and change INPUT (line 50) into PR1KT. Vol 
might also wish to delete line 60, to avoid the PRINTlng of a second field 
into record 13- 



CHAINING IN APPLESOFT 

To RUN a Series of Applesoft programs without erasing earlier values of 
variables- and arrays 

1) Place the Systco Hester diskette in your drive and 

BLOAD CHAIN, A2056 ( BLOAD CHAIN, A12296 

In diskette Applesoft) 

2) Place In the drive the dtykette ulilrh will have the chained 
programs and use the command 

BSAVE CHAIN, A2056, L'.56 ( BSAVE CHAIN, A12296, L456 

in diskette Applesoft) 
to put the machine language CHAIN program onto the diBkctte. 

3) Suppose you wish program PART QUE to chain to the program 
PART TWO. First, isake aure the binary file CHAIN is on the 
earn* diskette with the progran PART TWO (see steps 1 and 2, 
above). Then simply insert these two 

lines as the last two lines to be executed in the PAflT ONE program! 
PRINT CHR$(£); "BLOAD CHAIN, A520" 
CALL 521t"PART TWO" 

No space or other character nay be between the Z and the " 

In the CALL cnmnfliid. 
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GENERAL INDEX 



Also see Che Protean Index and Che Message Index at the end of this 
section, on page 176 • Inside the manual's back cover is the Command 
Summary Index and the Procedure Summary Index. 



-A- 

a: see A (address) pixwier.tr 

A-regiaeer 94-95 

A (address) parameter 92, 151* 

with BI.OAI) 93, 163 

with ERUH 93, 163 

with BSAVT. 92, 163 
absolute byte parameter 69-71 

12S 
absolute-field position 

(R) parameter ?9 
address field 94 
address (A) parameter 92, 150 
analog board acheaatlce 146 
APPEND 66-67, 159 
Apple I] BASIC frogr analog Manual 

IE) 
Applesoft BASIC 28-31, 136 

booting from 1 1 

firmware HOH card 107 

on diskette <RAH) 107,171 
Applesoft II BASIC Programing 

Reference Hnntjnl 10, 48 
APPLESOFT program 29, 107 

-I- 

b: see B (byte) parameter 
B (byte) parameter 69, 150 

with READ 69-71, 89 

with WRITE 69-71, 89 
backing up 37-38 
binary files 92 
BLOAD 93, I $3 
boat inf. 11-12, 166 
BRTO 45, 93, 163 
bsavk 92,163 
byte (B) parameter 69-71, 89, 150 

-c- 

C, control 18, 39 
C (command) parameter 

with HON 42, 155 

with NOHOH 42, 155 
cable 2-4 
CALL -131 29 



CALL -868 43 

cassette tape recorder 15, 25 

CATALOG 16, 152 

CHAIN 106, 158 

chaining In Applesoft 106-107, 
171 
In Integer BASIC 106, 158 

CHR$(4) 30, 166-167 

CLOSE 48 

random-access files 88, 161-162 
sequential files 58-59, 15S 

command (C) parameter 42 

run! ml rhdrdrter 17, 30, 148, 

151 
controller card 2-5, 22 
CONTACT 2 
COPY program 39-40 
copying 

diskettes 38-40 

programs 15-16 
text files 171 
CTRL (control) II, 14B 

CTRL-C 18 

CTRL-D 29-31, 156-157, 166-167 

CTRL-K 11, 103 

CTRL-F 11, 103 

-D- 

d: See D (drive) parameter 

PS 30, 166-167 

D, control 29-31, 156-157, 

1(6-161 
n (drive) parameter 22-23, 149 
data field 94 

data f i le: see sequential and 

random-access tent files 
debugging 42, 44, 154-155 
default values 22 

deferred-execution node 29-31, 48 
DELETE 18. 26, 134, 154 
device characteristics table 

94-98 
disk drive 

care 5-7 

.Installation 2-4 

multiple drives 5, 22 

troubleshooting 12 
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<!iski-t ti- 5-7 

catalog ib, 153 

Forut 94, 124-137 

IHITlnlUine, 11-14, IB, 166 

storage 124 

volume number 23 
BISK PULL 120, 134. 178 
display op! Whia: fief HON, NOHOtl 
DOS (Dllfc Operating System) 

eomaand summaries 110-111, 
148-16'.. lnalde back cover 

coimnandd fun wLrhln a program 
31. 166-167 

entry points 144 

I/O regiatera 101-103. 104 

■emory u&age 140-142 

neasages 114— 122 

procedure sunmarlas 165-171, 
i m Lde back cover 

delve option" see drive parameter 
drive (D) parnnvter 22 
duplicating disks 38-40 



FTID OF I1ATA 117, 1 78 

entry points to no a 144 
erasing filea 18, 26. ISA 
error codes 114-115 
error messages 114-122. 178 
ESC (escape) 11, 149 
EXEC 74-79. 160-161, 169 



field 51. 124 
field (R) paraaactr 

with EXEC 79, 160-161 

with POSITION 67-69, 160 
file 16 

data file: see sequential and 
random-access t*xt (ilea 

EXEC 75 

machine Language 92-9J 

tiaaca 16-17, 25, 151 

random— access text file 82— 39 

sequential text file 49-71 

text file 48 
file buffer 4), 124 
PILE LOOKED 120, 178 
FILE NOT FOUND 118, 178 
FILE TYPE MISMATCH 121, 178 
floating point BASIC: 

nee Applesoft BASIC 
FP 28-29, 156 



-©- 

GET with text file* SI 
gr«tl iitg iinigraa 11-14 
I i-ii.iuil ii/. 45 



-H- 

HELLO program 1 1 
hexadecimal notation 24 
HIHKMt 12, 141-142 



-I- 



I/O devices 100 

1/0 ERROR 119. 178 

1 (Input) parameter 42 

Laa ad . m e- e*ei u l I an mo&t 3 -48 

XHl 11. 100-102. 157 

indices 

command auanariea: 
I OS ide back cover 

general 174-177 

message 178 
procedure summaries i 

I US iile back , 
program 1 78 
MIT (IHITlalize) 11-14, 31, 151, 
166 

INPUT with teal I Hen 5! 

Input/Output control Block: 

see IOI1 
Input registers 

DOS 101, 104 

Monitor 101, 103 
Input (I) parameter 42 
Installing the DISK II 2-4 
INT 26-29, 156 
Integer BASIC 28-29, 156 

bootlnx from II 
interface circuit achcoatics 
IN USE light 7, IS 

I0B 94-98 



J: aee L (length) parameter 
JMF (junp) 93 
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-ft 

kick. Bee bnuthiR 
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LANCUACE TOT AVAILABLE 115, 178 
L {length) parameter 

with BSAVE 92, 1SSI, 163 

ullli OPEN 88, I'ih, 150, 161 
length (L) parameter 

or binary file 92. 15*1 

of record 88, 126, 150 
I.OAI1 15-16, 25-26, I S3 
LOCK 35, 151 

-M- 

machine-language files 92-93, 163 
imsti't diskettes 44-46 



MAXFI1.FS 31, 43-44, 
meeory requirements 
monory usage and nop 
message index 17R 
HON 62-43, 50, 155 
monitor 11, IS, 29, 
Monitor I/O registers 
105 



78, 155-156 
13, 140-142 
140-141 



166 

101-103, 



-N- 

NO BUFFERS AVAIM.BUE 121, ITS 
HOHOr: 42-43. 155 
NOT DIRECT COMMAND 1Z2, 178 
notntton 24, 148-150 



-O- 

(output) parameter 

with HON 42 

with NOHON 42 
ONERR GOTO codas 114-122 
OPF.N 48 

random-access files 88, 

sequential filej 56-59, 
output reglnterR 

nns 101, 106 

Monitor 101, 103 
overwriting 63-64, 



161 
156 



69 



-P- 



p: see relative-field position 

(R) parameter 
P, control 11, 103 



POSITION 66-69, 125, 136, 150, 

160-161 
PR* H, 100-182, 157 
PRINT (with CTRL-D) 29-31, 50 
program index 178 
PROGRAM TOO LARGE 29, 122, 178 
prompt characters 11, 36 



quotation (Ulrica 30 



-R- 

R paratsoiLT 

with EXEC 79, 150 

with POSITION 67-69, 125, 150 

with READ 67-69, 150 

uitli WHITE 67-68, 150 
random-access text file 82-89, 
161-162 

creating, retrieving. 82-85, 170 

differences from sequential 82 

sample prograiau 82-87 
RANGE ERROR 116, 178 
READ 

with rondom-accrad ti'Kl files 
88-89, 137, 162, 170 

with sequential text files 
49-71, 136, 159, 167-169 
read or write a track 

or sector fRWTS) 94-9B 
record 82-86, 126, 158 
record number (Ri parameter 82-86 
relative-field position 

(R) paraoeter 67-69 
RENAME 17, 153 
RESET 11, 18, 149. 166 
RETURN 11, 12, 149 
RETURN character 51 

ribbon cable 2-4 

RUN 25-26, 153 

RUTS subroutine 94-98 



s: see S (slot) parameter 
5 (slot) parameter 22, 149 
SAVE 15. 25-26, 152 
schematics 165-166 
sw-tot 16, 94-98, 124, 122-135 
allocation order 135 
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■equent ial text til* 49-71 -Y- -¥- -2* 

creating ond retrieving 49-71, 

raJTIJ! .69 T-w.i.«r W-M 

Sample programs 49-71 
slave diskettes 13. 44, 12.1 
■lots 3-4 

slot (5) parameter 22, 149 
syntsx 24, 148-15* 
SYNTAX ERROR 120, 17B 
System Haater diskette 10-14 



-T- 

text file 48-49. 171 
text file, random-access : 

see random-access text fill- 
text file* sequential: 

see sequential text file 
TRACE 44 

track allocation ardor 135 
track bit map 124, 133-134 
track/sector Hat 124, 128-129 
tracks 94-96, 124 
turnkey system 34-35, 167 



-u- 

UNLOCK 35, 154 

unpacking 2 

UPDATE 3.2 program 44-46 



-V- 

v: hvi' V (vrilumr 1 ) parameter 

V (volume} parameter 23-24, 149 

VERIFY 15-36, 154 

VOLUME MISMATCH llfl-119, 178 

volume number: 

see volume parameter 
volume (V) parorai.f-r 23-24, 149 
VTOC (volume table of contents) 

132-113 



-w- 

WR1TE 

with random-access text file* 

88-89, 126, 162 
with ftequential text files 
49-71, 124-m, IS9 
vrlte protecting 36-37 
WRITE PROTECTED 116-117, 178 
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DOS MESSAGE INDEX 

Appendix B, pages 114-122, gives the codes needed to use Applesoft's 
OKERR GOTO command to create Applesoft error-handltag routines £gr DOS 
errors . Suranjriry tell when each toessage presented by DOS Is likely 
to occur- Each summary colls what to do when the message le received. 



MESSAGE 

DISK : 

END OF DATA 

FILE LOCKED 
FILE KOT FOUND 
FILE TYPE MISMATCH 

I/O ERROR 

LANGUAGE HOT AVAILABLE 
NO BUFFERS AVAILABLE 

NOT DIRECT COMMAND 
PROGRAM TOO LARGE 
BAKE KKKOR 
SYNTAX ERROR 
VOLUME MISMATCH 
WRITE PROTECTED 



PACES 



120 














53. 


58. 


67, 


68, 


70. 


79, 


66. 




IL7- 


■118. 


160, 161 




35. 


67, 


120 










17, 


18, 


26, 


36, 


46. 


59, 


118, 154 


35, 


48, 


121, 


152 








22, 


26, 


36, 


ut, 


154 




28, 


IIS 


1*3 










43, 


121 


156 










*e. 


122 












29, 


122 












92. 


116 












10, 


26, 


28. 


79, 


92, 


120 




23, 


na- 


■119 










37. 


116 


-11? 











PROGRAM INDEX 

01 i In- nrogrnnra Listed below. CAFTURE and the tvo greeting programs arc 
discussed only In the manual. The remaining listed programs are also on 

the System Heater diskette- This list does net Include every program On 
the System Hester diskette, nor every program discussed In the manual - 



PROGRAM 



lUlSCKlETlOfJ 



PAGES 



Greeting (HELLO) progran 

Another greeting progr.ins 

COLOR I1EW1 

AMHAI.S 

COPY 

UPDATE 3.2 

MAKE TEST 

RETRIEVE TEXT 

EXEC I1EHO 

CAPTURE 

RANDOM and APPLE PROMS 

CIIAtH 



RUKa when disk Is booted 13-14 

shown CATALOG when disk is boottd 29-30 

dlyplayv Apple? colors an color TV 34—35 

builds n guess tng-game 37 

uses 2 drives to copy diskettes 3#-4S> 

converts slave diskette to master 44-46 

creates a sequential text tile 61-63 

retrieves a sequential text file 65-66 

ilrmn'1-,1 rntcs use of EXEC eormand 74—75 

captures a program us '■ i <■*' file 76-77 

shows use of random-access file 36-88 

allows chaining in Applesoft 106-107 
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INDEX TO DOS COMMAND SUMMARIES 



Command 


Page 






Connnand 


JMEr 


APPEND 


159 






MAXFI1.F.5 


155 


BLQAD 


163 






HON 


155 


BR.UK 


163 






nohow 


155 


BSAVK 


163 






OPEN 


153 


CATAUK 


152 








161 


CHAIN 


15B 






POSITION 


160 


CLOSE 


158 


[sequential 


files) 


PR# 


157 




161 


[r.iiidftfli-aef eftfi files) 


READ 


159 


CTRL-D 


llf, 








162 


DELETE 


154 






RENAME 


153 


EXEC 


160 






RUN 


153 


FP 


156 






SAVE 


152 


IN# 


157 






UNLOCK 


154 


INIT 


151 






VKKIFY 


154 


INT 


156 






WRITE 


159 


LOAD 


153 








162 


LOCK 


154 











(sequential files) 
(rendom-atcess files) 



(sequential filet) 
(randoo-accesa files) 



(sequential files) 
(random-access files) 



INDEX TO DOS PROCEDURE SUMMARIES 



Procedure 

Booting DOS 
INlTlallzlog a Diskette 

Recovering from Accidental RKKKTfl 

Use of DOS from, within a Progran 

Creating a Turnkey Syatem 

Creating and Retrieving Sequential Tent PI lea 

Adding Data to a Sequential Text File 

i:nnt rut I ing the ftppli vli i Sequential text His 

Creating and Retrieving Random-Access Text Files 

Copying a Text File onto Another Diskette 

Chaining in Applesoft 

Converting Machine-Language Program* to BASIC 

Setting HAXFILES within fin Integer BASIC Progran 



DOS VERSION 3.2 
CWICK REFERENCE CARD 

On this card, DOS cm— inds ire grojped into 
these 5 categories: 



Ha-JSekeeslr.K r 



nds: 



XHIT 


tout 


DELETE 


vraiiPT 


CATALOG 


■US 


LOCK 


KOM 


SAVE 


IBUM 


wooer. 


KM : 



HUCF1LE5 



Ac ccgs Co—mads; 



I=-p 



[MX 



ra* 



IN# 



Sequential Tect File Comsands: 
OPE. READ APPI 

CLOSE WRITE 



APPEKD 

rosiTios 



R-aadoe-Acceas "ere Flic C ou— ads: 



DPEJ. 



CLOSE 



Machine-Language File Co 



KF.AP 



■rids : 



CHATS 



- :■■•■'- 



UFITE 



3XOAD 



BK I! 



1SAVE 



NOTATION AND SYNTAX 

^v "parameter" is a capital letter, usually 
£7 allowed by * number (shown here by a 
Louer-eisc letter), which gives additional 
i. of oroat ior, for executing a command. 
Multiple parameters nay appear la any 
order, but most be separated Eroo each 
other try a coacu. A parameter shovn la 
square lb raciest* [llfce this] is optional- 



A* file hjk {Shown here h I ) must isnedl- 
ately fallow Its command word. File Banes 
■must begin with a letter; only the £lr*t 
5 characters are used. A comma separates 
m file name froa a following pffmrWi 

CTRL-D (type D while holding down CTStL key* 
Is used In Ft!*! statements to indicate :he 
s tart of a deferred-* sedation POS coaaaad. 
Integer 5AS1C example: 

If V-S- ' "" : REH "CTRL-D" 

21 PE.IKT -»S: '"CATALOG" 
Applesoft BASIC example: 

IB ftS » GH35<*( : HEM CTRL-D 

It PRIST C-S{ "CATALOG" 

riHe tera "BASIC" alor.e Is used to* mean either 
Integer BASIC or Applesoft BASIC. The tern 
"file" alone scans any type of diskette file. 



COMMAND PARAMETERS 

An error mess-age is ghin If a DOS command 

quantity is too large or coo small. 



ALL FILES 



Parameter 
Slot 
Drive 
"oluae 



As shewn 


Kin 


Has 


.55 


SI 


S7 


,Dd 


Dl 


D2 


.'.'•-■ 


It * 


V354 



• Using V9 is like omitting, the Vv parameter: 
the diskette's volume number is ignored. 
Smallest volume number IHIT vlll actually 
assign to a diskette is 1 . 



SEDjCEKTIAL TEXT FILES 

Psrsngter As ph. awn Min Has 

.Bb B0 132767 

,Rp K9 152767 



Byte 

Beiatlue Field * 



• With EXEC, always relative to field ■ - 



■AaWM-ACCESS TEXT iILES 



Parameter 


As sh«rn 


HIn 


Has 


■ecord Length 
Keecrd. Huafte? 


■fee 


LI 


LJ2767 
■52767 


BINARY FILES 








Para.se ter 


As shoara 


.Mln 


Kaji 


Starting Address 
Sumber of Bytes 


.As 
»LJ 


*9 
LI 


a$*5 35 

A3 2767 



J»5 CWsHAST'S 



Coamand 



PRI 
MAXFILES 



Quantity 



As shown 



Mln 



Wax 



slot 
slat 
file bailers 



PSf' s 

art s 

HAXFILES 



?B#a ?a#7 
is*? m#7 

n-1 ti-16 



Comaanda wie Slot or Drive parameter* only 
when char-gigs to a different Slot or Drive. 

If a command onits the Vallate pa canter or 
use* VII , the diskette's volume number is 
Ignored. A command that uses tbe VoLraaS 
parameter TW will not be ececated unless 
the diskette's volume mister 1b v . 



HOUSEKEEPING COMMANDS 

TJCII X !.*r] I .So] [,&d] 

Initializes a blank. diBkette to form a slave 
diskette. Assises greeting program naste X 
and volume number y (IF specif led 1 . SAVES 

the BASIC pr>graa currently in acacrf , under 
file cane X . 



CATALOC I.SsI I.Ddl 

Displays volume number and all files an a 
diskette, Bltli each file's- type and sector 
length. * indicates a LOCKed file. 



Jvpe_ 



DestriptloTi 



[Bow created > 



1 Integer BASIC program file (SAVE> 

A Applesoft BASIC program file (SAVE) 

T Test File COFQ*. then WRITE) 

a Binary memory-image file (B5AV51) 



SATE K I.Ssi [,Dd] l.Vv) 

Stores current BASIC prograo onto diskette, 
wvler file tuae X . Overvrtc.es any previous 
file of same type and name, without warning. 



LOAD K l,Ss] [,Bdl [,Vv] 

Loads BASIC program file X Into ceaory, 
after clearing a— cry and (if necessary) 
changing to the correct BASIC. 



KB X [,Ss] !|,Ddl I.VvJ 
LftAThs BASIC program file X 
then SITse Che program. 



BEUAKE X, V [.Sal [.Ml [,W1 

Changes a diskette file's name from X 



DELETE X I.SsJ [,E'd| |,Vw| 

Erases file K trca the diskette. 



LOCK X J.S.J [ t DdI |»VwJ 

Locks file X against accidental change or 

deletion. LOC&ed file shown Ln CATALOG by * 



UKLOCK X I.Ss] I.Ddl I.Vv) 
Unlocks previously LOCKed: file 
tc allow change cr deletion. 



VERIFY X r.S*J t,Pd] [,Vv| 

Checks file X for Internal consistency. 
If X UBS saved without errcr, no message 
is given. 



MOS |.C] I.I] f.0] 

Causes display of disk Ca amends ( C ). 
Input from the disk ( I > T and Output 
to the disk [ >. With no parameters. 
SOU is ignored. 



NOHOW [,C| l»Tj 1,0] 

Cancels display of disk Comnar.ds ( C >, 
.Input fronn the disk t I >, and Output 
to Che disk < ). With no parameters, 
NOHOH is Ignored. 



MAXFILES n 

Reserves n file buffers for disk input and 
output (booting reserves J file buffers). 
Use before LOAD! tig or MHInirig a prograi. 



ACCESS COMMANDS 



PP [,S9] I.Ddl |,Vv] 

Puts sj-stea into Applesoft BASIC. 

erasing any program in oenory. 



Puts sj'ateo Into Integer BASIC, 
erasing any pre gran in 0*00*7. 

FBI" s 

Sends subsequeat «utjmt to slot s ■ Boots 
disk If slot s contains disk controller 
card. PRtQ send* output to TV screen again. 



INF s 

Takes subsequent input from slot a . Boots 
disk if slot s contains disk controller 
card. Wtt takes input from keyboard again. 



CHAIK Y i.Ssl t.Ddl C.Vvl 

HUHs Integer BASIC program file Y , out does 
not clear variables developed by previous 
Integer BASIC program. 



SEQUENTIAL TEXT RLE COMMANDS 

OPEN X |.Sa| l.Dd] | r W) 

Opens or creates sequential test file X , 
allocates one file buffer and prepares to 
WRITE or ISA© froa beginning of file. 



CLOSE [XJ 

Completes WHITE X, if necessary, and de- 
allocates file buffet assigned to text file 
X . Without file name, CLOSES all OPES files 

(except an EXEC file). 



WRITE X J, Bo] 

Subsequent nUMEs send characters to 
sequential lei: file X . URlTEing kr^jins 
at current file position or r'lf specified! 
at byte b . Cancelled by any DOS ccamand. 



READ X I T Eb] 

Subsequent IKrUTs and GETs take response 
characters frwa sequential teat file X . 
SEADlng begins at current file position or 
<if specified) at byte b . INPUT response 
is one field (all characters to next 
RETVRMIr Cancelled by any DOS coamand. 



AFPEHD K I,Ss] I.Dd] [.VvJ 
Opens existing sequential t*xt file X 
sinllar to OPES, bus prepares to WRITE 
at the end of the file. 



POSITION K, Up 

In OPEB sequential text file X . subsequent 
HEAD or WRITE ulli proceed froa p—th field 

f ol lowing, current file position. 



EXEC X [,Rp] [,5s] f.Bd] 2,»V| 
Executes successive fields In sequential 
text file X as If typed at keyboard. 
With >p paraneter, execution begins ulib 
p-th field. Fields may include nunbered 
BASIC program lines and direct-execution 
BASIC or DOS commands to control the Apple. 



RAN DOM -ACCESS TEXT FILE 

COMMANDS 

opes z, i] [,s«i |»Btf] :.w] 

Opens or creates rsndoa-access text file X , 
allocates one file buffer, and defines record 
length as ] bytes- Prepares to HRITE or READ 
froe beginning of Fee ore a . Sase Length paraa— 
ecer ruac be used each, time file X Is OFEXcd- 



CLOSE HI |,Ss] [,Ddl |.Vv| 
Completes WRITE X. if necessary, and de- 
allccates file buffer assigned to text file 
X . Without file sane, C'„OSEs all OFEK files. 



WHITE K [.Sr| [,Bb* 

Subsequent PBlNTs send characters to randon- 
access test file X • With bo parameters, 
KPlTElng begins at current file position. 
With Kr paraneter alcne, WttlTEing star:? .!t 
byte of Record r . With 3b parameter. 
W5ITE starts at byte b of current or spec- 
ified Record. Cancelled by any DOS ec^njnd. 



READ X I .Br] i.Bb] 

Subsequent IKPDTa and GETs ta'ie response 
characters froc random-access text file X • 
With no parameters, READ log starts at cut- 
rent file position. With Rr paraneter 
alone, HEAEing starts at byte * of Record r. 
With Bb parameter, BEADing starts at byte 
b of current or specified Record. Id' PUT 
tesponse is one field (ail characters to 
next RETV1D9). Cancelled by amy DOS command. 

MACHINE-LANGUAGE FILE 
COMMANDS 

BSAVE X. Aa. L} [,Sa] |,Dd| I ,Vvl 
Stores oe diskette, under file name X , 
the contents of j oenory bjrtH starting 
ac address a ■ 



BLOA5 X [,Aa| |,S»3 t,Ml t,V»} 
Loads- binary file 3C Into same nenery 
locations froa vhl:fa file was BSAVEd cr 
(if specified] start Ids. at address a . 



BRDW X I.Aal |.S»3 I .Dd| I .Vv] 

BLOABs binary file I , Then jumps fJMP) 

to loaded (Hd's FilSt neoory address. 



^cippkz computer inc. 

10360 Bondley Drive 

Cupertino. California 9$Q\4 

(dOfi)W6-10lO 



